[Pkg-exim4-users] update-exim4.conf.8 is lacking information

[Regid Ichira]

  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