again, remind admins how to read man pages

1 files changed, 11 insertions, 5 deletions

diff --git a/share/man/man8/afterboot.8 b/share/man/man8/afterboot.8
index dab7493d525..f23bd4af54b 100644
--- a/share/man/man8/afterboot.8
+++ b/share/man/man8/afterboot.8
@@ -6,6 +6,7 @@
 .Nm afterboot
 .Nd things to check after the first complete boot
 .Sh DESCRIPTION
+.Ss Starting Out
 This document attempts to list items for the system administrator
 to check and set up after the installation and first complete boot of the
 system.
@@ -13,17 +14,22 @@ The idea is to create a list of items that can be checked off so that you have
 a warm fuzzy feeling that something obvious has not been missed.
 A basic knowledge of
 .Ux
-is assumed.
+is assumed, otherwise type
+.Pp
+.Dl Ic # help
 .Pp
 Complete instructions for correcting and fixing items is not provided.
 There are manual pages and other methodologies available for doing that.
 For example, to view the man page for the
 .Xr ls 1
 command, type:
-.Ic man 1 ls .
-.\"
-.\" XXX This should be an enumerated list
-.\"
+.Pp
+.Dl Ic man 1 ls
+.Pp
+Administrators will rapidly become more familiar with
+.Os
+if they get used to using the high quality manual pages.
+.Pp
 .Ss Errata
 By the time that you have installed your system, it is quite likely that
 bugs in the release have been found.