Bug#376459: exim4-config: issues with ACL documentation

[Marc Haber]

clone 376459 -1
reassign -1 tkman
retitle -1 tkman: displays exim4-config_files(5) strangely
thanks

On Sun, Jul 02, 2006 at 10:18:55PM -0700, Ross Boylan wrote:
> 4. There is an oddity in the exim4-config_files man page when viewed
> with tkman.  man in terminal looks OK.  In case there is something on
> the page that is inspiring this weird behavior, I'm reporting it.
> 
> Here's what I see when I expand the subitem under "description"
> --------------------------------------------------
> /etc/exim4/local_host_blacklist
> 	  is  an  optional  file  containing a list of IP addresses, networks and
> 	  host names whose  messages  will  be  denied  with  the  error  message
> 	  "locally  blacklisted". This is a full exim 4 host list, and all avail-
> 	  able features can be used. This includes negative items, and so  it  is
> 	  possible  to exclude addresses from being blacklisted. For convenience,
> 	  as an additional method to whitelist addresses from being  blocked,  an
> 	  explicit  whitelist  is  read  in from /etc/exim4/local_host_whitelist.
> 	  Entries in the whitelist override corresponding blacklist entries.
> 
> 	  In the blacklist, the trick is to read a line break as "or" if it  fol-
> 	  lows a positive item, and as "and" if it follows a negative item.
> 
> 	  For example, a /etc/exim4/local_host_blacklist
> 
> 	  192.168.10.0/24
> 	  !172.16.10.128/26
> 	  172.16.10.0/24
> 	  10.0.0.0/8
> 
> 	  Exim  just evaluates left to right (or up-down in the file listing con-
> 	  text), so you don't get the same kind of operator binding as in a  pro-
> 	  gramming language.
> XXXXXX
> 	  will  be   accepted   despite   the   address   is   also   listed   in
> 	  /etc/exim4/local_host_blacklist, overriding a blacklisting.
> 
> 
> /etc/exim4/local_sender_blacklist
> 	  is  an  optional files containing a list of envelope senders whose mes-
> ---------------------------------------------------------
> The section with XXX has missing material on local_host_whitelist.
> If I hit enter (which tells tkman to expand and move on) the missing
> text reappears.
> 
> I may be misunderstanding tkman, or it may be strictly a tkman bug.
> But if there's a way to prevent it from the man page itself, that
> would be a plus.

tkman maintainers, please investigate and advise whether my man page
is faulty or your package buggy. I'd appreciate a workaround which
might be possible in the exim4-config_files(5) man page.

Link to the man page in exim4 svn:
http://svn.debian.org/wsvn/pkg-exim4/exim/trunk/debian/manpages/exim4-config_files.5?op=file&rev=0&sc=0

Greetings
Marc

-- 
-----------------------------------------------------------------------------
Marc Haber         | "I don't trust Computers. They | Mailadresse im Header
Mannheim, Germany  |  lose things."    Winona Ryder | Fon: *49 621 72739834
Nordisch by Nature |  How to make an American Quilt | Fax: *49 621 72739835