[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/d9e903ef22b6
branches:  trunk
changeset: 983746:d9e903ef22b6
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 bf9ae80031b4 -r d9e903ef22b6 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 @@
 .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 @@
 .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 @@
 .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 @@
 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 @@
 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 @@
 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 @@
 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 @@
 .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 ,