misc/39168: afterboot(8) manpage needs update: outdated Postfix section (plus some minor additional changes)

[userresu%sdf.lonestar.org@localhost]

>Number:         39168
>Category:       misc
>Synopsis:       afterboot(8) manpage needs update: outdated Postfix section 
>(plus some minor additional changes)
>Confidential:   no
>Severity:       non-critical
>Priority:       medium
>Responsible:    misc-bug-people
>State:          open
>Class:          doc-bug
>Submitter-Id:   net
>Arrival-Date:   Fri Jul 18 14:20:00 +0000 2008
>Originator:     Anonymous
>Release:        CURRENT
>Organization:
>Environment:
>Description:
afterboot(8) doesn't describe Postfix as the default MTA, although that
is the case since NetBSD 4.0. Above that, some minor changes which would
make the text more clear are given in this PR.
>How-To-Repeat:
"man 8 afterboot"; search for the `Postfix' section (and other sections; see
patch below).
>Fix:
Proposed patch:

--- /usr/src/share/man/man8/afterboot.8 2008-07-18 13:52:53.000000000 +0200
+++ afterboot.8.new     2008-07-18 13:58:24.000000000 +0200
@@ -98,9 +98,9 @@
 Login as
 .Dq Ic root .
 You can do so on the console, or over the network using
-.Xr ssh 1 .
-If you have enabled the ssh daemon and wish to allow root logins over
-the network, edit the
+.Xr ssh 1
+in case you enabled the ssh daemon and allowed root logins over
+the network.  For this to happen, edit the
 .Pa /etc/ssh/sshd_config
 file and set
 .Cm PermitRootLogin
@@ -108,9 +108,9 @@
 .Dq yes
 (see
 .Xr sshd_config 5 ) .
-The default is to not permit root logins over the network
-after fresh install in
-.Nx .
+.Nx
+does not permit root logins over the network
+in its default configuration of the ssh daemon.
 .Pp
 Upon successful login on the console, you may see the message
 .Dq We recommend creating a non-root account... .
@@ -193,7 +193,7 @@
 or edit the
 .Pa /etc/myname
 file to have it stick around for the next reboot.
-Note that hostname is supposed include a domainname, and that this should
+Note that the hostname is supposed to include a domainname, and that this 
should
 not be confused with YP (NIS)
 .Xr domainname 1 .
 .Ss Verify network interface configuration
@@ -668,23 +668,21 @@
 Check
 .Pa /etc/mail/aliases
 and update appropriately if you want e-mail to be routed
-to non-local address or to different users.
+to non-local addresses or to different users.
 .Pp
 Run
 .Xr newaliases 1
 after changes.
 .Ss Postfix
 .Nx
-comes also with Postfix in the base system.
-You may wish to set it up in favor of sendmail.
-Take a look to
+includes Postfix as its MTA.  By default, it does not listen on
+the network for incoming connections; see the global configuration
+file
 .Pa /etc/postfix/main.cf
-and enable the daemon in
-.Pa /etc/rc.conf
-using "postfix=yes".
-It is very important to configure
+for instructions on how to accomplish this.
+To use another MTA (eg. sendmail), install and configure it, then edit 
 .Pa /etc/mailer.conf
-to point to Postfix binaries.
+to point to the correct binaries.
 .Ss DHCP server
 If this is a
 DHCP