Mdoc(7)ify.

usr.sbin/bootparamd/bootparamd/bootparamd.8

@@ -1,6 +1,6 @@
 .\" @(#)bootparamd.8
 .\" $FreeBSD$
-.Dd November 8, 1989
+.Dd December 14, 2000
 .Dt BOOTPARAMD 8
 .Os
 .Sh NAME
@@ -13,8 +13,9 @@
 .Op Fl f Ar file
 .Sh DESCRIPTION
 .Nm Bootparamd
-is a server process that provides information to diskless clients
-necessary for booting.
+is a server process that provides information to
+.Xr diskless 8
+clients necessary for booting.
 It consults the
 .Pa /etc/bootparams
 file. 
@@ -22,18 +23,21 @@ file.
 This version will allow the use of aliases on the hostname in the
 .Pa /etc/bootparams
 file.
-The returned hostname to the whoami request done by the booting client
+The returned hostname to the
+.Em whoami
+request done by the booting client
 will be the name that appears in 
 .Pa /etc/bootparams
 and not the canonical name.
 In this way you can keep the answer short enough
-so that machines that can not handle long hostnames won't fail during boot.
+so that machines that can not handle long hostnames will not fail during boot.
 .Sh OPTIONS
 .Bl -tag -width Fl
 .It Fl d
 Display the debugging information.
 .It Fl s
-Log the debugging information with syslog. 
+Log the debugging information with
+.Xr syslog 3 .
 .It Fl r Ar router
 The default router (a machine or an IP-address).
 This defaults to the machine running the server.
@@ -44,17 +48,28 @@ The file to use as boot parameter file instead of
 .Sh FILES
 .Bl -tag -width /etc/bootparams -compact
 .It /etc/bootparams
+default boot parameter file
 .El
 .Sh EXAMPLES
 When netbooting diskless SunOS/Xkernel SPARCstations the booted SunOS kernel
-also broadcasts to the all-0 address. The SunOS kernel hangs until it
-receives a reply. To accomodate this behaviour add an alias address 
-that responds to an all-0 broadcast. So, add something like 'ifconfig xl0
-192.168.200.254 netmask 255.255.255.255 broadcast 192.168.200.0 alias'
-on the relevant network interface on your bootparamd server. The alias
-address must of course be free for use.
+also broadcasts to the all-0 address.
+The SunOS kernel hangs until it receives a reply.
+To accommodate this behaviour add an alias address 
+that responds to an all-0 broadcast.
+So, add something like
+.Ql "ifconfig xl0 192.168.200.254 netmask 255.255.255.255 broadcast 192.168.200.0 alias
+on the relevant network interface on your
+.Nm
+server.
+The alias address must of course be free for use.
+.Sh SEE ALSO
+.Xr syslog 3 ,
+.Xr bootparams 5 ,
+.Xr diskless 8
 .Sh BUGS
-You may find the syslog loggings to be verbose.
+You may find the
+.Xr syslog 3
+loggings to be verbose.
 .Sh AUTHORS
 Written by
-.An Klas Heggemann Aq klas@nada.kth.se
+.An Klas Heggemann Aq klas@nada.kth.se .

usr.sbin/bootparamd/bootparamd/bootparams.5

@@ -1,3 +1,4 @@
+.hlm 0
 .\"
 .\" Copyright (c) 1994 Gordon W. Ross
 .\" All rights reserved.
@@ -39,18 +40,19 @@
 The
 .Nm
 file specifies the boot parameters that
-diskless
+.Xr diskless 8
 clients may request when booting over the network.
 Each client supported by this server must have an entry in the
 .Nm
 file containing the pathnames for its
-.Nm root
+.Dq root
 and (optionally)
-.Nm swap
+.Dq swap
 areas.
 .Pp
 Each line in the file
-(other than comment lines that begin with a #)
+(other than comment lines that begin with a
+.Ql # )
 specifies the client name followed by the pathnames that
 the client may request by their logical names.
 The components of the line are delimited with blank or tab,
@@ -63,12 +65,18 @@ dummy	root=host:/export/dummy/root \\
 	dump=host:/export/dummy/swap
 .Ed
 .Pp
-When the client named "dummy" requests the pathname for
-its logical "root" it will be given the pathname
-.Dq Pa "host:/export/dummy/root"
+When the client named
+.Dq dummy
+requests the pathname for its logical
+.Dq root
+it will be given the pathname
+.Dq Pa host:/export/dummy/root
 as the response to its
 .Tn RPC
-request.  The "host:" component must be supplied.
+request.
+The
+.Dq host:
+component must be supplied.
 .Sh FILES
 .Bl -tag -width /etc/bootparams -compact
 .It Pa /etc/bootparams