diff --git a/share/examples/isdn/i4brunppp/i4brunppp.8 b/share/examples/isdn/i4brunppp/i4brunppp.8 index c55a0e4cc07e..4dd54d9992df 100644 --- a/share/examples/isdn/i4brunppp/i4brunppp.8 +++ b/share/examples/isdn/i4brunppp/i4brunppp.8 @@ -32,7 +32,9 @@ .Nm i4brunppp .Nd interface i4b to userland ppp in server mode .Sh DESCRIPTION -.Nm i4brunppp +The +.Nm +utility is part of the isdn4bsd package and is used to interface i4b to the so-called userland .Xr ppp 8 diff --git a/share/man/man8/adding_user.8 b/share/man/man8/adding_user.8 index e803d89111ce..20a2e22232a2 100644 --- a/share/man/man8/adding_user.8 +++ b/share/man/man8/adding_user.8 @@ -113,5 +113,5 @@ User information should (and eventually will) be stored elsewhere. .Sh HISTORY The .Nm -procedure appeared in +utility appeared in .Bx 3.0 . diff --git a/share/man/man8/man8.alpha/MAKEDEV.8 b/share/man/man8/man8.alpha/MAKEDEV.8 index b9e6df33340d..60d20881647f 100644 --- a/share/man/man8/man8.alpha/MAKEDEV.8 +++ b/share/man/man8/man8.alpha/MAKEDEV.8 @@ -42,18 +42,18 @@ .Nm name ... .Sh DESCRIPTION -The shell script +The .Nm -found in the +utility is a shell script located in the .Dq Pa /dev -directory, is used to create the common special -files. +directory. It is used to create the common special files. See .Xr intro 4 for a more complete discussion of special files. .Pp +The .Nm -takes any number of device names as arguments, where the names are +utility takes any number of device names as arguments, where the names are the common abbreviation for the device. There are two special devices, .Dq std diff --git a/share/man/man8/man8.i386/MAKEDEV.8 b/share/man/man8/man8.i386/MAKEDEV.8 index 4542004b2079..85a99167950c 100644 --- a/share/man/man8/man8.i386/MAKEDEV.8 +++ b/share/man/man8/man8.i386/MAKEDEV.8 @@ -42,17 +42,18 @@ .Nm name ... .Sh DESCRIPTION -The shell script +The .Nm -found in the +utility is a shell script located in the .Dq Pa /dev -directory, is used to create the common special files. +directory. It is used to create the common special files. See .Xr intro 4 for a more complete discussion of special files. .Pp +The .Nm -takes any number of device names as arguments, where the names are +utility takes any number of device names as arguments, where the names are the common abbreviation for the device. There are two special devices, .Dq std diff --git a/share/man/man8/picobsd.8 b/share/man/man8/picobsd.8 index 404a87454450..561bd72451bc 100644 --- a/share/man/man8/picobsd.8 +++ b/share/man/man8/picobsd.8 @@ -11,8 +11,9 @@ .Op Ar options .Op Ar floppy-type Op Ar site-name .Sh DESCRIPTION +The .Nm -is a script which can be used to produce a minimal implementation of +utility is a script which produces a minimal implementation of .Fx (historically called .Nm PicoBSD ) @@ -20,8 +21,9 @@ which typically fits on one floppy disk, or can be downloaded as a single image file from some media such as CDROM, flash memory, or through .Xr etherboot . .Pp +The .Nm -was originally created to build simple standalone systems +utility was originally created to build simple standalone systems such as firewalls or bridges, but because of the ability to cross-build images with different source trees than the one in the server, it can be extremely useful to developers to @@ -664,7 +666,7 @@ created by .An Greg Lehey Aq grog@lemis.com . .Sh BUGS In order to build -.Nm , +.Nm Ns , the kernel of the system on which it is built must have the .Xr vn 4 driver installed. diff --git a/share/man/man8/rc.8 b/share/man/man8/rc.8 index 4f6d782034c7..d60d7ff9df49 100644 --- a/share/man/man8/rc.8 +++ b/share/man/man8/rc.8 @@ -53,8 +53,9 @@ .Nm rc.local .Nm rc.shutdown .Sh DESCRIPTION -.Nm Rc -is the command script which controls the automatic reboot +The +.Nm +utility is the command script which controls the automatic reboot (calling the other scripts) and .Nm rc.local is the script holding commands which are pertinent only @@ -63,8 +64,9 @@ mechanism is used instead of rc.local these days but if you do want to use rc.local, /etc/rc still supports it. In this case, rc.local should source /etc/rc.conf and contain additional custom startup code for your system. -.Nm Rc.conf -contains the global system configuration information referenced +The +.Nm rc.conf +file contains the global system configuration information referenced by the rc files, while .Nm rc.conf.local contains the local system configuration. @@ -137,8 +139,9 @@ but these may be overridden with the .Xr rc.conf 5 variable. .Pp -.Nm Rc.shutdown -is the command script which contains any necessary commands +The +.Nm rc.shutdown +script contains any necessary commands to be executed as the system is shut down. .Pp When an automatic reboot is in progress, @@ -168,18 +171,22 @@ starts all the daemons on the system, preserves editor files and clears the scratch directory .Pa /tmp . .Pp -.Nm Rc.early -is run very early in the startup process, immediately before the +The +.Nm rc.early +script is run very early in the startup process, immediately before the filesystem check. .Pp -.Nm Rc.serial -is used to set any special configurations for serial devices. +The +.Nm rc.serial +script is used to set any special configurations for serial devices. .Pp -.Nm Rc.pccard -is used to enable PC-cards. +The +.Nm rc.pccard +script is used to enable PC-cards. .Pp -.Nm Rc.network -is used to start the network. +The +.Nm rc.network +script is used to start the network. The network is started in three passes. The first pass sets the hostname and domainname, configures the network interfaces, turns on any IP firewall rules, and starts routing. @@ -187,8 +194,9 @@ The second pass starts most of the network related daemons. The third pass starts NFS, amd, rwhod, Kerberos and the multicast routing daemon. .Pp -.Nm Rc.firewall -is used to configure rules for the kernel based firewall +The +.Nm rc.firewall +script is used to configure rules for the kernel based firewall service. It has several possible options: .Pp @@ -207,19 +215,22 @@ disables the loading of firewall rules. will load the rules in the given filename (full path required). .El .Pp -.Nm Rc.atm -is used to configure ATM network interfaces. +The +.Nm rc.atm +script is used to configure ATM network interfaces. The interfaces are configured in three passes. The first pass performs the initial interface configuration. The second pass completes the interface configuration and defines PVCs and permanent ATMARP entries. The third pass starts any ATM daemons. .Pp -.Nm Rc. -runs architecture specific programs. +The +.Nm rc. +script runs architecture specific programs. .Pp -.Nm Rc.local -is executed after the scripts above, but before the rest of the +The +.Nm rc.local +script is executed after the scripts above, but before the rest of the .Nm file is completed. In a default installation @@ -267,5 +278,5 @@ is unnecessary, but is often included. .Sh HISTORY The .Nm -command appeared in +utility appeared in .Bx 4.0 .