Pkg exim4 users - Aug 2012 - update-exim4.conf.8 is lacking information

Would I better filed a bug, rather then posting to
pkg-exim4-users?

Package:  exim4-config
Version:  4.80-4
Severity: normal
Tags:     patch
File:     /usr/share/man/man8/update-exim4.conf.8

  update-exim4.conf.8 doesn''t mention /etc/mailname at all.  On the
other hand, it does describe the operation of
/usr/sbin/update-exim4.conf, and makes comments about replacing it
by a handcrafted script.
  The patch also mentions that a handcrafted version should return 
success (0) exit code.
  For these reasons, I suggest this patch:

--- a/update-exim4.conf.8       2012-08-17 15:34:53.111766133 +0300
+++ b/update-exim4.conf.8       2012-08-17 15:26:09.000000000 +0300
@@ -95,6 +95,8 @@ Exim will use this file if it exists and
 Additionally you might want to set
 .I dc_eximconfig_configtype=none
 in /etc/exim4/update\-exim4.conf.conf to stop debconf from asking you questions
about exim4.
+The handcrafted version should return success (0) exit code.
+One reason is that it is called by exim''s init script
/etc/init.d/exim4.

 .B update\-exim4.conf
 exits silently and does nothing if /etc/exim4/exim4.conf exists and \-o
@@ -139,6 +141,14 @@ variable CFILEMODE. If CFILEMODE is neit
 Change this to 0640 if you are keeping sensitive information (LDAP credentials
 et. al.) in there.

+One other file that
+.B update\-exim4.conf
+uses is /etc/mailname. Even though it was not mentioned so far by this+manual
page, it is an important file. It holds the system "mail name".
+This name will also be used by other programs. Which is why
+.B update\-exim4.conf
+is using the traditional file to read the name from.
+
 .SH CONFIGURATION VARIABLES
 All lists given in configuration variables are semicolon-separated. In
 the past, they used to be colon separated. This was changed to
@@ -314,6 +324,10 @@ would be greatly appreciated.
 .SH FILES
 .LP
 .TP
+.B /etc/mailname
+Traditional file to hold the system mail name.
+.LP
+.TP
 .B /var/lib/exim4/config.autogenerated
 Exim''s main configuration file
 .LP
@@ -330,6 +344,7 @@ which may be hand-edited, and is read as
 .SH SEE ALSO
 .BR exim (8),
 .BR exim4-config_files(5),
+.BR mailname(7),
 /usr/share/doc/exim4\-base/ and for general notes and details about interaction
 with debconf
 /usr/share/doc/exim4\-base/README.Debian.gz

On Fri, Aug 17, 2012 at 12:58:19PM -0700, Regid Ichira
wrote:
>   Would I better filed a bug, rather then posting to
> pkg-exim4-users?
Yes. It''s the way that makes sure that your input isn''t
missed.
>   update-exim4.conf.8 doesn''t mention /etc/mailname at all.
/etc/mailname is not our file, so it is not our field to document.
There are multiple different definitions, and we are not in a position
to declare ours the right one. The explanation of /etc/mailname was
therefore deliberately omitted.

Greetings
Marc

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

--- On Sun, 8/19/12, Marc Haber wrote:
> >???update-exim4.conf.8 doesn''t mention
> /etc/mailname at all.
> 
> /etc/mailname is not our file, so it is not our field to
> document.
> There are multiple different definitions, and we are not in
> a position
> to declare ours the right one. The explanation of
> /etc/mailname was
> therefore deliberately omitted.
> 
  update-exim4.conf does use /etc/mailname, doesn''t it?  In that case,
I think update-exim4.conf.8 should, at least, mention that somehow.
The README does mention it.