Sort SENDMAIL_* entries so I can...

MFC: You can never have enough documentation.

     Document the SENDMAIL_ALIASES, SENDMAIL_MAP_SRC, SENDMAIL_MAP_TYPE, and
     SENDMAIL_START_SCRIPT
     .Xr make.conf 5
     variables.
     These are used in
     .Pa /etc/mail/Makefile .

     PR:       conf/40548

     Revision  Changes    Path
     1.140     +40 -0     src/share/man/man5/make.conf.5

1 files changed, 93 insertions, 53 deletions

diff --git a/share/man/man5/make.conf.5 b/share/man/man5/make.conf.5
index 440498b8351d..5622ae1a4b24 100644
--- a/share/man/man5/make.conf.5
+++ b/share/man/man5/make.conf.5
@@ -680,32 +680,6 @@ Set to install BIND libraries and include files.
 Set to disable the installation of
 .Xr ppp 8
 as an suid root program.
-.It Va SENDMAIL_MC
-.Pq Vt str
-The default
-.Xr m4 1
-configuration file to use at install time.
-The value should include the full path to the
-.Pa .mc
-file, e.g.,
-.Pa /etc/mail/myconfig.mc .
-Use with caution as a make install will overwrite any existing
-.Pa /etc/mail/sendmail.cf .
-Note that
-.Va SENDMAIL_CF
-is now deprecated.
-.It Va SENDMAIL_SUBMIT_MC
-.Pq Vt str
-The default
-.Xr m4 1
-configuration file for mail submission
-to use at install time.
-The value should include the full path to the
-.Pa .mc
-file, e.g.,
-.Pa /etc/mail/mysubmit.mc .
-Use with caution as a make install will overwrite any existing
-.Pa /etc/mail/submit.cf .
 .It Va SENDMAIL_ADDITIONAL_MC
 .Pq Vt str
 Additional
@@ -718,24 +692,14 @@ The value should include the full path to the
 file(s), e.g.,
 .Pa /etc/mail/foo.mc
 .Pa /etc/mail/bar.mc .
-.It Va SENDMAIL_CF_DIR
-.Pq Vt str
-Override the default location for the
-.Xr m4 1
-configuration files used to build a
-.Pa .cf
-file from a
-.Pa .mc
-file.
-.It Va SENDMAIL_M4_FLAGS
+.It Va SENDMAIL_ALIASES
 .Pq Vt str
-Flags passed to
-.Xr m4 1
-when building a
-.Pa .cf
-file from a
-.Pa .mc
-file.
+List of
+.Xr aliases 5
+files to rebuild when using
+.Pa /etc/mail/Makefile .
+The default value is
+.Pa /etc/mail/aliases .
 .It Va SENDMAIL_CFLAGS
 .Pq Vt str
 Flags to pass to the compile command when building
@@ -748,11 +712,18 @@ SENDMAIL_CFLAGS=-I/usr/local/include -DSASL
 SENDMAIL_LDFLAGS=-L/usr/local/lib
 SENDMAIL_LDADD=-lsasl
 .Ed
-.It Va SENDMAIL_LDFLAGS
+.It Va SENDMAIL_CF_DIR
 .Pq Vt str
-Flags to pass to the
-.Xr ld 1
-command when building
+Override the default location for the
+.Xr m4 1
+configuration files used to build a
+.Pa .cf
+file from a
+.Pa .mc
+file.
+.It Va SENDMAIL_DPADD
+.Pq Vt str
+Extra dependencies to add when building
 .Xr sendmail 8 .
 .It Va SENDMAIL_LDADD
 .Pq Vt str
@@ -760,10 +731,60 @@ Flags to add to the end of the
 .Xr ld 1
 command when building
 .Xr sendmail 8 .
-.It Va SENDMAIL_DPADD
+.It Va SENDMAIL_LDFLAGS
 .Pq Vt str
-Extra dependencies to add when building
+Flags to pass to the
+.Xr ld 1
+command when building
 .Xr sendmail 8 .
+.It Va SENDMAIL_M4_FLAGS
+.Pq Vt str
+Flags passed to
+.Xr m4 1
+when building a
+.Pa .cf
+file from a
+.Pa .mc
+file.
+.It Va SENDMAIL_MAP_PERMS
+.Pq Vt str
+Mode to use when generating alias and map database files using
+.Pa /etc/mail/Makefile .
+The default value is 0640.
+.It Va SENDMAIL_MAP_SRC
+.Pq Vt str
+Additional maps to rebuild when using
+.Pa /etc/mail/Makefile .
+The 
+.Pa access ,
+.Pa bitdomain ,
+.Pa domaintable ,
+.Pa genericstable ,
+.Pa mailertable ,
+.Pa uucpdomain ,
+and
+.Pa virtusertable
+maps are always rebuilt if they exist.
+.It Va SENDMAIL_MAP_TYPE
+.Pq Vt str
+Database map type to use when generating map database files using
+.Pa /etc/mail/Makefile .
+The default value is hash.
+The alternative is btree.
+.It Va SENDMAIL_MC
+.Pq Vt str
+The default
+.Xr m4 1
+configuration file to use at install time.
+The value should include the full path to the
+.Pa .mc
+file, e.g.,
+.Pa /etc/mail/myconfig.mc .
+Use with caution as a make install will overwrite any existing
+.Pa /etc/mail/sendmail.cf .
+Note that
+.Va SENDMAIL_CF
+is now deprecated.
 .It Va SENDMAIL_SET_USER_ID
 .Pq Vt bool
 If set, install
@@ -774,11 +795,30 @@ and do not install
 Use of this flag is not recommended and the alternative advice in
 .Pa /etc/mail/README
 should be followed instead if at all possible.
-.It Va SENDMAIL_MAP_PERMS
+.It Va SENDMAIL_START_SCRIPT
 .Pq Vt str
-Mode to use when generating alias and map database files using
-.Pa /etc/mail/Makefile .
-The default value is 0640.
+The script used by
+.Pa /etc/mail/Makefile
+to start, stop, and restart
+.Xr sendmail 8 .
+The default value is
+.Pa /etc/rc.sendmail .
+This value should match the
+.Dq Li mta_start_script
+setting in
+.Xr rc.conf 5 .
+.It Va SENDMAIL_SUBMIT_MC
+.Pq Vt str
+The default
+.Xr m4 1
+configuration file for mail submission
+to use at install time.
+The value should include the full path to the
+.Pa .mc
+file, e.g.,
+.Pa /etc/mail/mysubmit.mc .
+Use with caution as a make install will overwrite any existing
+.Pa /etc/mail/submit.cf .
 .It Va TOP_TABLE_SIZE
 .Pq Vt int
 .Xr top 1