[src/trunk]: src/share/man/man8 adjust layout of afterboot(8) to make things ...

[nia <nia%NetBSD.org@localhost>]

details:   https://anonhg.NetBSD.org/src/rev/71565f4a52ae
branches:  trunk
changeset: 379522:71565f4a52ae
user:      nia <nia%NetBSD.org@localhost>
date:      Fri Jun 04 11:48:18 2021 +0000

description:
adjust layout of afterboot(8) to make things easier to find

diffstat:

 share/man/man8/afterboot.8 |  152 +++++++++++++++++++++-----------------------
 1 files changed, 71 insertions(+), 81 deletions(-)

diffs (216 lines):

diff -r 8a92dd357ad5 -r 71565f4a52ae share/man/man8/afterboot.8
--- a/share/man/man8/afterboot.8        Fri Jun 04 11:33:18 2021 +0000
+++ b/share/man/man8/afterboot.8        Fri Jun 04 11:48:18 2021 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: afterboot.8,v 1.77 2021/06/04 11:33:18 nia Exp $
+.\"    $NetBSD: afterboot.8,v 1.78 2021/06/04 11:48:18 nia Exp $
 .\"    $OpenBSD: afterboot.8,v 1.72 2002/02/22 02:02:33 miod Exp $
 .\"
 .\" Originally created by Marshall M. Midden -- 1997-10-20, m4%umn.edu@localhost
@@ -160,8 +160,11 @@ user, add said user to the
 .Dq wheel
 group, then use the
 .Xr su 1
-command when root privileges are required.
-This process is described in more detail later.
+command when root privileges are required:
+.Bd -literal -offset indent
+.Ic useradd -G wheel -m myuser
+.Ic passwd myuser
+.Ed
 .Ss Root password
 Change the password for the root user.
 (Note that throughout the documentation, the term
@@ -207,7 +210,7 @@ Set the time zone to Eastern Europe Summ
 .Ss Console settings
 One of the first things you will likely need to do is to set up your
 keyboard map (and maybe some other aspects about the system console).
-To change your keyboard encoding, edit the
+To change your keyboard layout, edit the
 .Dq Va encoding
 variable found in
 .Pa /etc/wscons.conf .
@@ -422,7 +425,9 @@ first, and then the DNS resolver specifi
 .Pa /etc/resolv.conf .
 .Pp
 Multicast DNS and DNS Service Discovery are usually not enabled by
-default on a fresh NetBSD system, and can be enabled by setting
+default on a fresh
+.Nx
+system, and can be enabled by setting
 .Dq mdnsd=YES
 in
 .Pa /etc/rc.conf ,
@@ -610,36 +615,6 @@ Refer to the above example and
 for information on the format of this file.
 .Pp
 You may wish to do NFS mounts now too, or you can do them later.
-.Ss Concatenated disks (ccd)
-If you are using
-.Xr ccd 4
-concatenated disks, edit
-.Pa /etc/ccd.conf .
-You may wish to take a look to
-.Xr ccdconfig 8
-for more information about this file.
-Use the
-.Ic ccdconfig -U
-command to unload and the
-.Ic ccdconfig -C
-command to create tables internal to the kernel for the concatenated disks.
-You then
-.Xr mount 8 ,
-.Xr umount 8 ,
-and edit
-.Pa /etc/fstab
-as needed.
-.Ss Automounter daemon (AMD)
-To use the
-.Xr amd 8
-automounter, create the
-.Pa /etc/amd
-directory, copy example config files from
-.Pa /usr/share/examples/amd
-to
-.Pa /etc/amd
-and customize them as needed.
-Alternatively, you can get your maps with YP.
 .Ss Clock synchronization
 In order to make sure the system clock is synchronized
 to that of a publicly accessible NTP server,
@@ -658,6 +633,30 @@ See
 and
 .Xr timed 8
 for more information on setting the system's date.
+.Ss Insalling packages
+The
+.Nx
+packages collection, pkgsrc, includes a large set of third-party software.
+A lot of it is available as binary packages that you can download from
+.Lk https://cdn.NetBSD.org/pub/pkgsrc/packages/NetBSD/
+or a mirror.
+.Pp
+For most users, using pkgin to manage binary packages is recommended.
+.Pp
+To install pkgin, if it was not done by the installer:
+.Bd -literal -offset indent
+.Ic PKG_PATH=https://cdn.NetBSD.org/pub/pkgsrc/packages/NetBSD/[...]
+.Ic export PKG_PATH
+.Ic pkg_add pkgin
+.Ic pkgin update
+.Ic pkgin install bash mpg123 fluxbox ...
+.Ed
+.Pp
+See
+.Lk https://www.pkgsrc.org/
+and
+.Pa pkgsrc/doc/pkgsrc.txt
+for more details.
 .Sh CHANGING /etc FILES
 The system should be usable now, but you may wish to do more customizing,
 such as adding users, etc.
@@ -747,6 +746,36 @@ directly, edit only
 See
 .Xr rc.conf 5
 for further information.
+.Ss Automounter daemon (AMD)
+To use the
+.Xr amd 8
+automounter, create the
+.Pa /etc/amd
+directory, copy example config files from
+.Pa /usr/share/examples/amd
+to
+.Pa /etc/amd
+and customize them as needed.
+Alternatively, you can get your maps with YP.
+.Ss Concatenated disks (ccd)
+If you are using
+.Xr ccd 4
+concatenated disks, edit
+.Pa /etc/ccd.conf .
+You may wish to take a look to
+.Xr ccdconfig 8
+for more information about this file.
+Use the
+.Ic ccdconfig -U
+command to unload and the
+.Ic ccdconfig -C
+command to create tables internal to the kernel for the concatenated disks.
+You then
+.Xr mount 8 ,
+.Xr umount 8 ,
+and edit
+.Pa /etc/fstab
+as needed.
 .Ss X Display Manager
 If you've installed X, you may want to turn on
 .Xr xdm 1 ,
@@ -933,46 +962,14 @@ Use
 and
 .Xr chown 8
 as needed.
-.Ss Packages
-Install your own packages.
-The
-.Nx
-packages collection, pkgsrc, includes a large set of third-party software.
-A lot of it is available as binary packages that you can download from
-.Lk https://cdn.NetBSD.org/pub/pkgsrc/packages/NetBSD/
-or a mirror.
-.Pp
-For most users, using pkgin to manage binary packages is recommended.
-.Pp
-To install pkgin, if it was not done by the installer:
-.Bd -literal -offset indent
-.Ic PKG_PATH=https://cdn.NetBSD.org/pub/pkgsrc/packages/NetBSD/[...]
-.Ic export PKG_PATH
-.Ic pkg_add pkgin
-.Ic pkgin update
-.Ic pkgin install bash mpg123 fluxbox ...
-.Ed
+.Sh SYSTEM TESTING
+At this point, the system should be fully configured to your liking.
+It is now a good time to ensure that the system behaves according to
+its specifications and that it is stable on your hardware.
+Please refer to
+.Xr tests 7
+for details on how to do so.
 .Pp
-See
-.Lk https://www.pkgsrc.org/
-and
-.Pa pkgsrc/doc/pkgsrc.txt
-for more details.
-.Pp
-Copy vendor binaries and install them.
-You will need to install any shared libraries, etc.
-(Hint:
-.Ic man -k compat
-to find out how to install and use compatibility mode.)
-.Pp
-There is also other third-party software that is available
-in source form only, either because it has not been ported to
-.Nx
-yet, because licensing restrictions make binary redistribution
-impossible, or simply because you want to build your own binaries.
-Sometimes checking the mailing lists for
-past problems that people have encountered will result in a fix posted.
-.Ss Check the running system
 You can use
 .Xr ps 1 ,
 .Xr netstat 1 ,
@@ -984,13 +981,6 @@ Other tools you may find useful are
 .Xr systat 1
 and
 .Xr top 1 .
-.Sh SYSTEM TESTING
-At this point, the system should be fully configured to your liking.
-It is now a good time to ensure that the system behaves according to
-its specifications and that it is stable on your hardware.
-Please refer to
-.Xr tests 7
-for details on how to do so.
 .Sh SEE ALSO
 .Xr chgrp 1 ,
 .Xr chmod 1 ,