Module Name:    src
Committed By:   nia
Date:           Fri Jun  4 11:48:18 UTC 2021

Modified Files:
        src/share/man/man8: afterboot.8

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


To generate a diff of this commit:
cvs rdiff -u -r1.77 -r1.78 src/share/man/man8/afterboot.8

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.

Modified files:

Index: src/share/man/man8/afterboot.8
diff -u src/share/man/man8/afterboot.8:1.77 src/share/man/man8/afterboot.8:1.78
--- src/share/man/man8/afterboot.8:1.77	Fri Jun  4 11:33:18 2021
+++ src/share/man/man8/afterboot.8	Fri Jun  4 11:48:18 2021
@@ -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, m...@umn.edu
@@ -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
-.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.)
+.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
-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 ,

Reply via email to