Added internal cross references for all man pages.

Jeremy.
(This used to be commit 9dd09fdb643b70e5b46aeb9f6580128b7a68fe4e)

11 files changed, 129 insertions, 23 deletions

diff --git a/docs/yodldocs/make_smbcodepage.1.yo b/docs/yodldocs/make_smbcodepage.1.yo
index 86d63d957c..6b59d5e01e 100644
--- a/docs/yodldocs/make_smbcodepage.1.yo
+++ b/docs/yodldocs/make_smbcodepage.1.yo
@@ -8,7 +8,7 @@ manpagename(make_codepage)(Construct a codepage file for Samba)
 label(SYNOPSIS)
 manpagesynopsis() 
 
-bf(make_smbcodepage) [c|d] codepage inputfile outputfile
+bf(make_smbcodepage) [link(c|d)(cord)] link(codepage)(codepage) link(inputfile)(inputfile) link(outputfile)(outputfile)
 
 label(DESCRIPTION)
 manpagedescription()
@@ -23,18 +23,22 @@ manpageoptions()
 
 startdit()
 
+label(cord)
 dit(c|d) This tells make_smbcodepage if it is compiling (c) a text
 format code page file to binary, or (d) de-compiling a binary codepage
 file to text.
 
+label(codepage)
 dit(codepage) This is the codepage we are processing (a number, eg. 850).
 
+label(inputfile)
 dit(inputfile) This is the input file to process. In the 'c' case this
 will be a text codepage definition file such as the ones found in the
 Samba em(source/codepages) directory. In the 'd' case this will be the
 binary format codepage definition file normally found in the
 em(lib/codepages) directory in the Samba install directory path.
 
+label(outputfile)
 dit(outputfile) This is the output file to produce.
 
 endit()
diff --git a/docs/yodldocs/nmbd.8.yo b/docs/yodldocs/nmbd.8.yo
index 42fb0b3876..f241af1d0e 100644
--- a/docs/yodldocs/nmbd.8.yo
+++ b/docs/yodldocs/nmbd.8.yo
@@ -9,7 +9,7 @@ naming services to clients)
 label(SYNOPSIS)
 manpagesynopsis()
 
-bf(nmbd) [-D] [-o] [-a] [-H lmhosts file] [-d debuglevel] [-l log file basename] [-n primary NetBIOS name] [-p port number] [-s configuration file] [-i NetBIOS scope] [-h]
+bf(nmbd) [link(-D)(minusD)] [link(-o)(minuso)] [link(-a)(minusa)] [link(-H lmhosts file)(minusH)] [link(-d debuglevel)(minusd)] [link(-l log file basename)(minusl)] [link(-n primary NetBIOS name)(minusn)] [link(-p port number)(minusp)] [link(-s configuration file)(minuss)] [link(-i NetBIOS scope)(minusi)] [link(-h)(minush)]
 
 label(DESCRIPTION)
 manpagedescription()
@@ -49,19 +49,23 @@ manpageoptions()
 
 startdit()
 
+label(minusD)
 dit(bf(-D)) If specified, this parameter causes the server to operate
 as a daemon. That is, it detaches itself and runs in the background,
 fielding requests on the appropriate port. By default, the server will
 NOT operate as a daemon. nmbd can also be operated from the inetd
 meta-daemon, although this is not recommended.
 
+label(minusa)
 dit(bf(-a)) If this parameter is specified, each new connection will
 append log messages to the log file.  This is the default.
 
+label(minuso)
 dit(bf(-o)) If this parameter is specified, the log files will be
 overwritten when opened.  By default, the log files will be appended
 to.
 
+label(minusH)
 dit(bf(-H filename)) NetBIOS lmhosts file.
 
 The lmhosts file is a list of NetBIOS names to IP addresses that is
@@ -77,6 +81,7 @@ build process. Common defaults are em(/usr/local/samba/lib/lmhosts),
 em(/usr/samba/lib/lmhosts) or em(/etc/lmhosts). See the bf(lmhosts
 (5)) man page for details on the contents of this file.
 
+label(minusd)
 dit(bf(-d debuglevel)) debuglevel is an integer from 0 to 10.
 
 The default value if this parameter is not specified is zero.
@@ -92,6 +97,11 @@ should only be used when investigating a problem. Levels above 3 are
 designed for use only by developers and generate HUGE amounts of log
 data, most of which is extremely cryptic.
 
+Note that specifying this parameter here will override the url(bf(log
+level))(smb.conf.5.html#loglevel) parameter in the url(bf(smb.conf
+(5)))(smb.conf.5.html) file.
+
+label(minusl)
 dit(bf(-l logfile)) The bf(-l) parameter specifies a path and base
 filename into which operational data from the running nmbd server will
 be logged.  The actual log file name is generated by appending the
@@ -103,17 +113,20 @@ The default log file path is is compiled into Samba as part of the
 build process. Common defaults are em(/usr/local/samba/var/log.nmb),
 em(/usr/samba/var/log.nmb) or em(/var/log/log.nmb).
 
+label(minusn)
 dit(bf(-n primary NetBIOS name)) This option allows you to override
 the NetBIOS name that Samba uses for itself. This is identical to
 setting the bf(NetBIOS name) parameter in the smb.conf file
 but will override the setting in the smb.conf file.
 
+label(minusp)
 dit(bf(-p UDP port number)) UDP port number is a positive integer value.
 
 This option changes the default UDP port number (normally 137) that
 nmbd responds to name queries on. Don't use this option unless you are
 an expert, in which case you won't need help!
 
+label(minuss)
 dit(bf(-s configuration file)) The default configuration file name is
 set at build time, typically as em(/usr/local/samba/lib/smb.conf), but
 this may be changed when Samba is autoconfigured.
@@ -121,6 +134,7 @@ this may be changed when Samba is autoconfigured.
 The file specified contains the configuration details required by the
 server.  See bf(smb.conf (5)) for more information.
 
+label(minusi)
 dit(bf(-i scope)) This specifies a NetBIOS scope that the server will use
 to communicate with when generating NetBIOS names. For details on the
 use of NetBIOS scopes, see rfc1001.txt and rfc1002.txt. NetBIOS scopes
@@ -128,6 +142,7 @@ are em(very) rarely used, only set this parameter if you are the
 system administrator in charge of all the NetBIOS systems you
 communicate with.
 
+label(minush)
 dit(bf(-h)) Prints the help information (usage) for nmbd.
 
 endit()
diff --git a/docs/yodldocs/nmblookup.1.yo b/docs/yodldocs/nmblookup.1.yo
index 20316ad3c6..af04e6b1e9 100644
--- a/docs/yodldocs/nmblookup.1.yo
+++ b/docs/yodldocs/nmblookup.1.yo
@@ -8,7 +8,7 @@ manpagename(nmblookup)(NetBIOS over TCP/IP client used to lookup NetBIOS names)
 label(SYNOPSIS)
 manpagesynopsis() 
 
-bf(nmblookup) [-M] [-R] [-S] [-r] [-A] [-h] [-B broadcast address] [-U unicast address] [-d debuglevel] [-s smb config file] [-i NetBIOS scope] name
+bf(nmblookup) [link(-M)(minusM)] [link(-R)(minusR)] [link(-S)(minusS)] [link(-r)(minusr)] [link(-A)(minusA)] [link(-h)(minush)] [link(-B broadcast address)(minusB)] [link(-U unicast address)(minusU)] [link(-d debuglevel)(minusd)] [link(-s smb config file)(minuss)] [link(-i NetBIOS scope)(minusi)] link(name)(name)
 
 label(DESCRIPTION)
 manpagedescription()
@@ -25,9 +25,11 @@ manpageoptions()
 
 startdit()
 
+label(minusM)
 dit(bf(-M)) Searches for a master browser. This is done by doing a
 broadcast lookup on the special name tt(__MSBROWSE__).
 
+label(minusR)
 dit(bf(-R)) Set the recursion desired bit in the packet to do a
 recursive lookup. This is used when sending a name query to a machine
 running a WINS server and the user wishes to query the names in the
@@ -35,9 +37,11 @@ WINS server.  If this bit is unset the normal (broadcast responding)
 NetBIOS processing code on a machine is used instead. See rfc1001,
 rfc1002 for details.
 
+label(minusS)
 dit(bf(-S)) Once the name query has returned an IP address then do a
 node status query as well.
 
+label(minusr)
 dit(bf(-r)) Try and bind to UDP port 137 to send and receive UDP
 datagrams. The reason for this option is a bug in Windows 95 where it
 ignores the source port of the requesting packet and only replies to
@@ -46,11 +50,14 @@ needed to bind to this port, and in addition, if the
 url(bf(nmbd))(nmbd.8.html) daemon is running on this machine it also
 binds to this port.
 
+label(minusA)
 dit(bf(-A)) Interpret <name> as an IP Address and do a node status
 query on this address.
 
+label(minush)
 dit(bf(-h)) Print a help (usage) message.
 
+label(minusB)
 dit(bf(-B broadcast address)) Send the query to the given broadcast
 address. Without this option the default behavior of nmblookup is to
 send the query to the broadcast address of the primary network
@@ -58,10 +65,12 @@ interface as either auto-detected or defined in the
 url(bf(interfaces))(smb.conf.5.html#interfaces) parameter of the 
 url(bf(smb.conf (5)))(smb.conf.5.html) file.
 
+label(minusU)
 dit(bf(-U unicast address)) Do a unicast query to the specified
 address or host tt("unicast address"). This option (along with the
-bf(-R) option) is needed to query a WINS server.
+link(bf(-R))(minusR) option) is needed to query a WINS server.
 
+label(minusd)
 dit(bf(-d debuglevel)) debuglevel is an integer from 0 to 10.
 
 The default value if this parameter is not specified is zero.
@@ -75,6 +84,17 @@ should only be used when investigating a problem. Levels above 3 are
 designed for use only by developers and generate HUGE amounts of
 data, most of which is extremely cryptic.
 
+Note that specifying this parameter here will override the url(bf(log
+level))(smb.conf.5.html#loglevel) parameter in the url(bf(smb.conf
+(5)))(smb.conf.5.html) file.
+
+label(minuss)
+dit(bf(-s smb.conf)) This parameter specifies the pathname to the
+Samba configuration file, smb.conf. This file controls all aspects of
+the Samba setup on the machine and smbclient also needs to read this
+file.
+
+label(minusi)
 dit(bf(-i scope)) This specifies a NetBIOS scope that smbclient will use
 to communicate with when generating NetBIOS names. For details on the
 use of NetBIOS scopes, see rfc1001.txt and rfc1002.txt. NetBIOS scopes
@@ -82,6 +102,7 @@ are em(very) rarely used, only set this parameter if you are the
 system administrator in charge of all the NetBIOS systems you
 communicate with.
 
+label(name)
 dit(bf(name)) This is the NetBIOS name being queried. Depending upon
 the previous options this may be a NetBIOS name or IP address. If a
 NetBIOS name then the different name types may be specified by
@@ -113,7 +134,8 @@ This man page is correct for version 2.0 of the Samba suite.
 label(SEEALSO)
 manpageseealso()
 
-url(bf(samba (7)))(samba.7.html), url(bf(nmbd (8)))(nmbd.8.html), url(bf(smb.conf (5)))(smb.conf.5.html)
+url(bf(samba (7)))(samba.7.html), url(bf(nmbd (8)))(nmbd.8.html),
+url(bf(smb.conf (5)))(smb.conf.5.html)
 
 label(AUTHOR)
 manpageauthor()
diff --git a/docs/yodldocs/smbclient.1.yo b/docs/yodldocs/smbclient.1.yo
index 1d2b2ed38b..3a7a4f0520 100644
--- a/docs/yodldocs/smbclient.1.yo
+++ b/docs/yodldocs/smbclient.1.yo
@@ -193,6 +193,10 @@ letter 'A', then em(all) debug messages will be printed. This setting
 is for developers only (and people who em(really) want to know how the
 code works internally).
 
+Note that specifying this parameter here will override the url(bf(log
+level))(smb.conf.5.html#loglevel) parameter in the url(bf(smb.conf
+(5)))(smb.conf.5.html) file.
+
 label(minusP)
 dit(bf(-P)) If this option is specified, the service requested will be
 connected to as a printer service rather than as a normal filespace
diff --git a/docs/yodldocs/smbd.8.yo b/docs/yodldocs/smbd.8.yo
index 9e22093cfa..c5a3f9314d 100644
--- a/docs/yodldocs/smbd.8.yo
+++ b/docs/yodldocs/smbd.8.yo
@@ -8,8 +8,7 @@ manpagename(smbd)(server to provide SMB/CIFS services to clients)
 label(SYNOPSIS)
 manpagesynopsis()
 
-bf(smbd) [-D] [-a] [-o] [-d debuglevel] [-l log file] [-p port number]
-[-O socket options] [-s configuration file] [-i scope] [-P] [-h]
+bf(smbd) [link(-D)(minusD)] [link(-a)(minusa)] [link(-o)(minuso)] [link(-d debuglevel)(minusd)] [link(-l log file)(minusl)] [link(-p port number)(minusp)] [link(-O socket options)(minusO)] [link(-s configuration file)(minuss)] [link(-i scope)(minusi)] [link(-P)(minusP)] [link(-h)(minush)]
 
 label(DESCRIPTION)
 manpagedescription()
@@ -51,6 +50,7 @@ manpageoptions()
 
 startdit()
 
+label(minusD)
 dit(bf(-D)) If specified, this parameter causes the server to operate as a
 daemon. That is, it detaches itself and runs in the background,
 fielding requests on the appropriate port. Operating the server as a
@@ -59,13 +59,16 @@ more than casual use file and print services.
 
 By default, the server will NOT operate as a daemon. 
 
+label(minusa)
 dit(bf(-a)) If this parameter is specified, each new connection will
 append log messages to the log file.  This is the default.
 
+label(minuso)
 dit(bf(-o)) If this parameter is specified, the log files will be
 overwritten when opened.  By default, the log files will be appended
 to.
 
+label(minusd)
 dit(bf(-d debuglevel)) debuglevel is an integer from 0 to 10.
 
 The default value if this parameter is not specified is zero.
@@ -81,18 +84,25 @@ should only be used when investigating a problem. Levels above 3 are
 designed for use only by developers and generate HUGE amounts of log
 data, most of which is extremely cryptic.
 
-dit(bf(-l log file)) If specified, em(logfile) specifies a log
-filename into which informational and debug messages from the running
-server will be logged. The log file generated is never removed by the
-server although its size may be controlled by the url(bf(max log
-size))(smb.conf.5.html#maxlogsize) option in the url(bf(smb.conf
+Note that specifying this parameter here will override the url(bf(log
+level))(smb.conf.5.html#loglevel) parameter in the url(bf(smb.conf
+(5)))(smb.conf.5.html) file.
+
+label(minusl) 
+dit(bf(-l log file)) If specified, em(log file) specifies
+a log filename into which informational and debug messages from the
+running server will be logged. The log file generated is never removed
+by the server although its size may be controlled by the url(bf(max
+log size))(smb.conf.5.html#maxlogsize) option in the url(bf(smb.conf
 (5)))(smb.conf.5.html) file.  The default log file name is specified
 at compile time.
 
+label(minusO)
 dit(bf(-O socket options)) See the url(bf(socket
 options))(smb.conf.5.html#socketoptions) parameter in the
 url(bf(smb.conf (5)))(smb.conf.5.html) file for details.
 
+label(minusp)
 dit(bf(-p port number)) port number is a positive integer value.  The
 default value if this parameter is not specified is 139.
 
@@ -112,6 +122,7 @@ rfc1002.txt section 4.3.5.
 This parameter is not normally specified except in the above
 situation.
 
+label(minuss)
 dit(bf(-s configuration file)) The default configuration file name is
 determined at compile time.
 
@@ -121,6 +132,7 @@ information such as what printcap file to use, as well as descriptions
 of all the services that the server is to provide. See bf(smb.conf
 (5)) for more information.
 
+label(minusi)
 dit(bf(-i scope)) This specifies a NetBIOS scope that the server will use
 to communicate with when generating NetBIOS names. For details on the
 use of NetBIOS scopes, see rfc1001.txt and rfc1002.txt. NetBIOS scopes
@@ -128,8 +140,10 @@ are em(very) rarely used, only set this parameter if you are the
 system administrator in charge of all the NetBIOS systems you
 communicate with.
 
+label(minush)
 dit(bf(-h)) Prints the help information (usage) for smbd.
 
+label(minusP)
 dit(bf(-P)) Passive option. Causes smbd not to send any network traffic
 out. Used for debugging by the developers only.
 
diff --git a/docs/yodldocs/smbpasswd.8.yo b/docs/yodldocs/smbpasswd.8.yo
index d633099035..d84450ad87 100644
--- a/docs/yodldocs/smbpasswd.8.yo
+++ b/docs/yodldocs/smbpasswd.8.yo
@@ -8,7 +8,7 @@ manpagename(smbpasswd)(change a users SMB password)
 label(SYNOPSIS)
 manpagesynopsis() 
 
-bf(smbpasswd) [-a] [-d] [-e] [-D debug level] [-n] [-r remote_machine] [-R name resolve order] [-m] [-j DOMAIN] [-U username] [-h] [-s] username
+bf(smbpasswd) [link(-a)(minusa)] [link(-d)(minusd)] [link(-e)(minuse)] [link(-D debug level)(minusD)] [link(-n)(minusn)] [link(-r remote_machine)(minusr)] [link(-R name resolve order)(minusR)] [link(-m)(minusm)] [link(-j DOMAIN)(minusj)] [link(-U username)(minusU)] [link(-h)(minush)] [link(-s)(minuss)] link(username)(username)
 
 label(DESCRIPTION)
 manpagedescription()
@@ -55,6 +55,7 @@ manpageoptions()
 
 startdit()
 
+label(minusa)
 dit(bf(-a)) This option specifies that the username following should
 be added to the local url(bf(smbpasswd))(smbpasswd.5.html) file, with
 the new password typed (type <Enter> for the old password). This
@@ -84,6 +85,7 @@ formats.
 
 This option is only available when running bf(smbpasswd) as root.
 
+label(minuse)
 dit(bf(-e)) This option specifies that the username following should be
 em(enabled) in the local url(bf(smbpasswd))(smbpasswd.5.html) file,
 if the account was previously disabled. If the account was not
@@ -112,6 +114,7 @@ should only be used when investigating a problem. Levels above 3 are
 designed for use only by developers and generate HUGE amounts of log
 data, most of which is extremely cryptic.
 
+label(minusn)
 dit(bf(-n)) This option specifies that the username following should
 have their password set to null (i.e. a blank password) in the local
 url(bf(smbpasswd))(smbpasswd.5.html) file. This is done by writing the
@@ -128,14 +131,15 @@ url(null passwords = true)(smb.conf.5.html#nullpasswords)
 
 This option is only available when running bf(smbpasswd) as root.
 
-label(minusr) dit(bf(-r remote machine name)) This option allows a
+label(minusr) 
+dit(bf(-r remote machine name)) This option allows a
 user to specify what machine they wish to change their password
 on. Without this parameter bf(smbpasswd) defaults to the local
 host. The em("remote machine name") is the NetBIOS name of the
 SMB/CIFS server to contact to attempt the password change. This name
 is resolved into an IP address using the standard name resolution
 mechanism in all programs of the url(bf(Samba))(samba.7.html)
-suite. See the link(bf(-R name resolve order))(nameresolveorder) parameter for details on changing this resolving
+suite. See the link(bf(-R name resolve order))(minusR) parameter for details on changing this resolving
 mechanism.
 
 The username whose password is changed is that of the current UNIX
@@ -148,27 +152,32 @@ specified must be the Primary Domain Controller for the domain (Backup
 Domain Controllers only have a read-only copy of the user account
 database and will not allow the password change).
 
-label(nameresolveorder)
+label(minusR)
 dit(bf(-R name resolve order)) This option allows the user of
 smbclient to determine what name resolution services to use when
 looking up the NetBIOS name of the host being connected to.
 
-The options are :"lmhosts", "host", "wins" and "bcast". They cause
-names to be resolved as follows :
+The options are :link("lmhosts")(lmhosts), link("host")(host),
+link("wins")(wins) and link("bcast")(bcast). They cause names to be
+resolved as follows :
 
 startit()
 
+label(lmhosts)
 it() bf(lmhosts) : Lookup an IP address in the Samba lmhosts file.
 
+label(host)
 it() bf(host) : Do a standard host name to IP address resolution,
 using the system /etc/hosts, NIS, or DNS lookups. This method of name
 resolution is operating system depended for instance on IRIX or
 Solaris this may be controlled by the em(/etc/nsswitch.conf) file).
 
+label(wins)
 it() bf(wins) : Query a name with the IP address listed in the url(bf(wins
 server))(smb.conf.5.html#winsserver) parameter in the smb.conf file. If 
 no WINS server has been specified this method will be ignored.
 
+label(bcast)
 it() bf(bcast) : Do a broadcast on each of the known local interfaces
 listed in the url(bf(interfaces))(smb.conf.5.html#interfaces) parameter
 in the smb.conf file. This is the least reliable of the name resolution
@@ -186,6 +195,7 @@ The default order is lmhosts, host, wins, bcast and without this
 parameter or any entry in the url(bf(smb.conf))(smb.conf.5.html) 
 file the name resolution methods will be attempted in this order.
 
+label(minusm)
 dit(bf(-m)) This option tells bf(smbpasswd) that the account being
 changed is a em(MACHINE) account. Currently this is used when Samba is
 being used as an NT Primary Domain Controller. PDC support is not a
@@ -196,6 +206,7 @@ email(samba-ntdom@samba.anu.edu.au).
 
 This option is only available when running bf(smbpasswd) as root.
 
+label(minusj)
 dit(bf(-j DOMAIN)) This option is used to add a Samba server into a
 Windows NT Domain, as a Domain member capable of authenticating user
 accounts to any Domain Controller in the same way as a Windows NT
@@ -238,6 +249,17 @@ user to specify the user name on that machine whose password will be
 changed. It is present to allow users who have different user names on
 different systems to change these passwords.
 
+label(minush)
+dit(bf(-h)) This option prints the help string for bf(smbpasswd), 
+selecting the correct one for running as root or as an ordinary user.
+
+label(minuss)
+dit(bf(-s)) This option causes bf(smbpasswd) to be silent (ie. not
+issue prompts) and to read it's old and new passwords from standard 
+input, rather than from tt(/dev/tty) (like the bf(passwd (1)) program
+does). This option is to aid people writing scripts to drive bf(smbpasswd)
+
+label(username)
 dir(bf(username)) This specifies the username for all of the em(root
 only) options to operate on. Only root can specify this parameter as
 only root has the permission needed to modify attributes directly
diff --git a/docs/yodldocs/smbrun.1.yo b/docs/yodldocs/smbrun.1.yo
index 32f44821fa..7db843cd47 100644
--- a/docs/yodldocs/smbrun.1.yo
+++ b/docs/yodldocs/smbrun.1.yo
@@ -8,7 +8,7 @@ manpagename(smbrun)(interface program between smbd and external programs)
 label(SYNOPSIS)
 manpagesynopsis() 
 
-bf(smbrun) shell-command
+bf(smbrun) link(shell-command)(shellcommand)
 
 label(DESCRIPTION)
 manpagedescription()
@@ -29,6 +29,7 @@ manpageoptions()
 
 startdit()
 
+label(shellcommand)
 dit(bf(shell-command)) The shell command to execute.  The command
 should have a fully-qualified path.
 
diff --git a/docs/yodldocs/smbstatus.1.yo b/docs/yodldocs/smbstatus.1.yo
index c58e84cda0..9a76bdcd7f 100644
--- a/docs/yodldocs/smbstatus.1.yo
+++ b/docs/yodldocs/smbstatus.1.yo
@@ -8,7 +8,7 @@ manpagename(smbstatus)(report on current Samba connections)
 label(SYNOPSIS)
 manpagesynopsis() 
 
-bf(smbstatus) [-b] [-d] [-L] [-p] [-S] [-s configuration file] [-u username]
+bf(smbstatus) [link(-b)(minusb)] [link(-d)(minusd)] [link(-L)(minusL)] [link(-p)(minusp)] [link(-S)(minusS)] [link(-s configuration file)(minuss)] [link(-u username)(minusu)]
 
 label(DESCRIPTION)
 manpagedescription()
@@ -23,22 +23,29 @@ manpageoptions()
 
 startdit()
 
+label(minusb)
 dit(bf(-b)) gives brief output.
 
+label(minusd)
 dit(bf(-d)) gives verbose output.
 
+label(minusL)
 dit(bf(-L)) causes smbstatus to only list locks.
 
+label(minusp)
 dit(bf(-p)) print a list of url(bf(smbd))(smbd.8.html)
 processes and exit. Useful for scripting.
 
+label(minusS)
 dit(bf(-S)) causes smbstatus to only list shares.
 
+label(minuss)
 dit(bf(-s configuration file)) The default configuration file name is
 determined at compile time. The file specified contains the
 configuration details required by the server. See url(bf(smb.conf
 (5)))(smb.conf.5.html) for more information.
 
+label(minusu)
 dit(bf(-u username)) selects information relevant to em(username)
 only.
 
diff --git a/docs/yodldocs/smbtar.1.yo b/docs/yodldocs/smbtar.1.yo
index 27b4466777..8f62c3a1f6 100644
--- a/docs/yodldocs/smbtar.1.yo
+++ b/docs/yodldocs/smbtar.1.yo
@@ -8,7 +8,7 @@ manpagename(smbtar)(shell script for backing up SMB/CIFS shares directly to UNIX
 label(SYNOPSIS)
 manpagesynopsis()
 
-bf(smbtar) -s server [-p password] [-x service] [-X] [-d directory] [-u user] [-t tape] [-b blocksize] [-N filename] [-i] [-r] [-l log level] [-v] filenames
+bf(smbtar) link(-s server)(minuss) [link(-p password)(minusp)] [link(-x service)(minusx)] [link(-X)(minusX)] [link(-d directory)(minusd)] [link(-u user)(minusu)] [link(-t tape)(minust)] [link(-b blocksize)(minusb)] [link(-N filename)(minusN)] [link(-i)(minusi)] [link(-r)(minusr)] [link(-l log level)(minusl)] [link(-v)(minusv)] filenames
 
 label(DESCRIPTION)
 manpagedescription()
@@ -24,22 +24,29 @@ manpageoptions()
 
 startdit()
 
+label(minuss)
 dit(bf(-s server)) The SMB/CIFS server that the share resides upon.
 
+label(minusx)
 dit(bf(-x service)) The share name on the server to connect
 to. The default is tt(backup).
 
+label(minusX)
 dit(bf(-X)) Exclude mode. Exclude filenames... from tar create or
 restore.
 
+label(minusd)
 dit(bf(-d directory)) Change to initial em(directory) before restoring
 / backing up files.
 
+label(minusv)
 dit(bf(-v)) Verbose mode.
 
+label(minusp)
 dit(bf(-p password)) The password to use to access a share. Default:
 none
 
+label(minusu)
 dit(bf(-u user)) The user id to connect as. Default: UNIX login name.
 
 label(minust)
@@ -47,19 +54,24 @@ dit(bf(-t tape)) Tape device. May be regular file or tape
 device. Default: em(TAPE) environmental variable; if not set, a file
 called tt(tar.out).
 
+label(minusb)
 dit(bf(-b blocksize)) Blocking factor. Defaults to 20. See bf(tar (1))
 for a fuller explanation.
 
+label(minusN)
 dit(bf(-N filename)) Backup only files newer than filename. Could be
 used (for example) on a log file to implement incremental backups.
 
+label(minusi)
 dit(bf(-i)) Incremental mode; tar files are only backed up if they
 have the archive bit set. The archive bit is reset after each file is
 read.
 
+label(minusr)
 dit(bf(-r)) Restore. Files are restored to the share from the tar
 file.
 
+label(minusl)
 dit(bf(-l log level)) Log (debug) level. Corresponds to the
 url(bf(-d))(smbclient.1.html#minusd) flag of url(bf(smbclient
 (1)))(smbclient.1.html).
diff --git a/docs/yodldocs/testparm.1.yo b/docs/yodldocs/testparm.1.yo
index 7ed84eee5e..1ff31adcf8 100644
--- a/docs/yodldocs/testparm.1.yo
+++ b/docs/yodldocs/testparm.1.yo
@@ -8,7 +8,7 @@ manpagename(testparm)(check an smb.conf configuration file for internal correctn
 label(SYNOPSIS)
 manpagesynopsis() 
 
-bf(testparm) [configfilename [hostname hostIP] ]
+bf(testparm) [link(configfilename)(configfilename) [link(hostname)(hostname) link(hostIP)(hostIP)] ]
 
 label(DESCRIPTION)
 manpagedescription()
@@ -33,10 +33,12 @@ manpageoptions()
 
 startdit()
 
+label(configfilename)
 dit(bf(configfilename)) This is the name of the configuration file to
 check. If this parameter is not present then the default
 url(bf(smb.conf))(smb.conf.5.html) file will be checked.
 
+label(hostname)
 dit(bf(hostname)) If this parameter and the following are specified,
 then testparm will examine the url(bf("hosts
 allow"))(smb.conf.5.html#hostsallow) and url(bf("hosts
@@ -46,6 +48,7 @@ with this IP address would be allowed acces to the
 url(bf(smbd))(smbd.8.html) server. If this parameter is supplied, the
 hostIP parameter must also be supplied.
 
+label(hostIP)
 dit(bf(hostIP)) This is the IP address of the host specified in the
 previous parameter. This address must be supplied if the hostname
 parameter is supplied.
diff --git a/docs/yodldocs/testprns.1.yo b/docs/yodldocs/testprns.1.yo
index b76fc9f3c4..4ad996da3f 100644
--- a/docs/yodldocs/testprns.1.yo
+++ b/docs/yodldocs/testprns.1.yo
@@ -8,7 +8,7 @@ manpagename(testparm)(check printer name for validity with smbd )
 label(SYNOPSIS)
 manpagesynopsis() 
 
-bf(testprns) printername [printcapname]
+bf(testprns) link(printername)(printername) [link(printcapname)(printcapname)]
 
 label(DESCRIPTION)
 manpagedescription()
@@ -28,6 +28,7 @@ manpageoptions()
 
 startdit()
 
+label(printername)
 dit(bf(printername)) The printer name to validate.
 
 Printer names are taken from the first field in each record in the
@@ -39,6 +40,7 @@ more forgiving or less forgiving than bf(testprns). However, if
 bf(testprns) finds the printer then url(bf(smbd))(smbd.8.html) should
 do so as well.
 
+label(printcapname)
 dit(bf(printcapname)) This is the name of the printcap file within
 which to search for the given printer name.