From 3c57dc77537bfff8a25b061e147f5a1194613a28 Mon Sep 17 00:00:00 2001 From: mpp Date: Mon, 8 Apr 1996 04:18:31 +0000 Subject: Correct some man page xrefs, and some other minor changes to bring some man pages up to mdoc guidelines and fix some minor formatting glitches. Also fixed a number of man pages to not abuse the .Xr macro to display functions and path names and a lot of other junk. --- gnu/usr.bin/ld/ldconfig/ldconfig.8 | 24 +++++++-------- gnu/usr.bin/man/makewhatis/makewhatis.1 | 5 ++-- lib/libc/gen/glob.3 | 4 +-- lib/libc/gen/nlist.3 | 4 +-- lib/libc/net/linkaddr.3 | 2 +- libexec/rbootd/rbootd.8 | 3 +- sbin/init/init.8 | 34 +++++++++++----------- sbin/ldconfig/ldconfig.8 | 24 +++++++-------- share/man/man3/sysexits.3 | 4 +-- share/man/man4/icmp.4 | 4 +-- share/man/man4/ip.4 | 9 +++--- share/man/man4/netintro.4 | 10 +++---- share/man/man4/pty.4 | 16 +++++----- share/man/man4/su.4 | 2 +- share/man/man4/tcp.4 | 8 ++--- share/man/man4/termios.4 | 50 ++++++++++++++++++++++---------- share/man/man4/udp.4 | 4 +-- share/man/man4/uk.4 | 2 +- share/man/man4/worm.4 | 4 +-- share/man/man4/yp.4 | 34 ++++++++++++---------- share/man/man5/fs.5 | 2 +- share/man/man5/fstab.5 | 4 +-- share/man/man5/link.5 | 47 ++++++++++++++++++++---------- share/man/man5/networks.5 | 2 +- share/man/man5/printcap.5 | 10 +++---- share/man/man5/remote.5 | 18 ++++++------ share/man/man5/utmp.5 | 4 +-- share/man/man7/clocks.7 | 19 +++++++----- share/man/man7/environ.7 | 16 ++++++---- share/man/man7/hier.7 | 2 +- share/man/man8/rc.8 | 2 +- share/man/man8/yp.8 | 34 ++++++++++++---------- usr.bin/ar/ar.5 | 4 +-- usr.bin/key/key.1 | 2 +- usr.bin/tip/tip/modems.5 | 8 ++--- usr.bin/ul/ul.1 | 7 +++-- usr.sbin/amd/amq/amq.8 | 6 ++-- usr.sbin/lpr/lpc/lpc.8 | 6 ++-- usr.sbin/lpr/lpr/lpr.1 | 3 +- usr.sbin/lpr/lpr/printcap.5 | 10 +++---- usr.sbin/lptcontrol/lptcontrol.8 | 4 +-- usr.sbin/pkg_install/add/pkg_add.1 | 2 +- usr.sbin/pkg_install/create/pkg_create.1 | 4 +-- usr.sbin/rpc.yppasswdd/rpc.yppasswdd.8 | 4 +-- 44 files changed, 259 insertions(+), 208 deletions(-) diff --git a/gnu/usr.bin/ld/ldconfig/ldconfig.8 b/gnu/usr.bin/ld/ldconfig/ldconfig.8 index 9b83224..8f055c0 100644 --- a/gnu/usr.bin/ld/ldconfig/ldconfig.8 +++ b/gnu/usr.bin/ld/ldconfig/ldconfig.8 @@ -27,7 +27,7 @@ .\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. .\" -.\" $Id: ldconfig.8,v 1.6 1994/12/23 22:31:21 nate Exp $ +.\" $Id: ldconfig.8,v 1.7 1995/06/24 10:08:43 asami Exp $ .\" .Dd October 3, 1993 .Dt LDCONFIG 8 @@ -44,16 +44,16 @@ is used to prepare a set of .Dq hints for use by the run-time linker -.Xr ld.so +.Xr ld.so 1 to facilitate quick lookup of shared libraries available in multiple directories. It scans a set of built-in system directories and any .Ar directories specified on the command line (in the given order) looking for shared libraries and stores the results in the file -.Xr /var/run/ld.so.hints +.Pa /var/run/ld.so.hints to forestall the overhead that would otherwise result from the directory search operations -.Xr ld.so +.Xr ld.so 1 would have to perform to load the required shared libraries. .Pp The shared libraries so found will be automatically available for loading @@ -69,12 +69,12 @@ directories where shared libraries might be found. is a .Sq \: separated list of directory paths which are searched by -.Xr ld.so +.Xr ld.so 1 when it needs to load a shared library. It can be viewed as the run-time equivalent of the .Fl L switch of -.Xr ld. +.Xr ld 1 . .Pp .Nm Ldconfig is typically run as part of the boot sequence. @@ -84,13 +84,13 @@ The following options recognized by .Bl -tag -width indent .It Fl m Instead of replacing the contents of -.Xr ld.so.hints +.Pa ld.so.hints with those found in the directories specified, .Dq merge in new entries. .It Fl r Lists the current contents of -.Xr ld.so.hints +.Pa ld.so.hints on the standard output. The hints file will not be modified. .It Fl s Do not scan the built-in system directory @@ -103,9 +103,9 @@ Special care must be taken when loading shared libraries into the address space of .Ev set-user-Id programs. Whenever such a program is run, -.Xr ld.so +.Nm ld.so will only load shared libraries from the -.Ev ld.so.hints +.Pa ld.so.hints file. In particular, the .Ev LD_LIBRARY_PATH is not used to search for libraries. Thus, the role of ldconfig is dual. In @@ -114,13 +114,13 @@ specify the trusted collection of directories from which shared objects can be safely loaded. It is presumed that the set of directories specified to .Nm ldconfig are under control of the system's administrator. -.Xr ld.so +.Nm ld.so further assists set-user-Id programs by erasing the .Ev LD_LIBRARY_PATH from the environment. .Sh FILES -.Xr /var/run/ld.so.hints +.Pa /var/run/ld.so.hints .Sh SEE ALSO .Xr ld 1 , .Xr link 5 diff --git a/gnu/usr.bin/man/makewhatis/makewhatis.1 b/gnu/usr.bin/man/makewhatis/makewhatis.1 index 4570b58..2165440 100644 --- a/gnu/usr.bin/man/makewhatis/makewhatis.1 +++ b/gnu/usr.bin/man/makewhatis/makewhatis.1 @@ -30,7 +30,7 @@ .\" .\" Email: Wolfram Schneider .\" -.\" $Id: makewhatis.1,v 1.1 1995/02/15 22:52:51 joerg Exp $ +.\" $Id: makewhatis.1,v 1.2 1995/03/31 04:00:51 joerg Exp $ .\" .Dd Jan, 12, 1995 @@ -108,8 +108,7 @@ Create whatis database for all directories in your .Ic makewhatis -outfile /tmp/mywhatis /usr/local/man $HOME/man .Pp Create whatis database -.Pa /tmp/mywhatis -\&. +.Pa /tmp/mywhatis . Traverse directories .Pa /usr/local/man and diff --git a/lib/libc/gen/glob.3 b/lib/libc/gen/glob.3 index 65c5674..4e3625b 100644 --- a/lib/libc/gen/glob.3 +++ b/lib/libc/gen/glob.3 @@ -223,8 +223,8 @@ strings like .Xr csh 1 . The pattern .Ql {} -is left unexpanded for historical reasons -.Xr (Csh 1 +is left unexpanded for historical reasons (and +.Xr csh 1 does the same thing to ease typing of diff --git a/lib/libc/gen/nlist.3 b/lib/libc/gen/nlist.3 index 11c9ee4..981a4c8 100644 --- a/lib/libc/gen/nlist.3 +++ b/lib/libc/gen/nlist.3 @@ -46,8 +46,8 @@ The .Fn nlist function retrieves name list entries from the symbol table of an -executable file. (See -.Xr a.out 5 . ) +executable file (see +.Xr a.out 5 ) . The argument .Fa \&nl is set to reference the diff --git a/lib/libc/net/linkaddr.3 b/lib/libc/net/linkaddr.3 index 52e3324..82a6297 100644 --- a/lib/libc/net/linkaddr.3 +++ b/lib/libc/net/linkaddr.3 @@ -101,7 +101,7 @@ has no return value. (See .Sx BUGS . ) .Sh SEE ALSO -.Xr iso 4 , +.Xr iso 4 .Sh HISTORY The .Fn link_addr diff --git a/libexec/rbootd/rbootd.8 b/libexec/rbootd/rbootd.8 index f4eb364..4db4d6e 100644 --- a/libexec/rbootd/rbootd.8 +++ b/libexec/rbootd/rbootd.8 @@ -149,8 +149,7 @@ process id .Xr kill 1 , .Xr socket 2 , .Xr signal 3 , -.Xr syslog 3 , -.Xr rmp 4 +.Xr syslog 3 .Sh BUGS If multiple servers are started on the same interface, each will receive and respond to the same boot packets. diff --git a/sbin/init/init.8 b/sbin/init/init.8 index 50caf0c..7618468 100644 --- a/sbin/init/init.8 +++ b/sbin/init/init.8 @@ -133,14 +133,14 @@ processes for the terminal ports found in the file reads this file, and executes the command found in the second field. This command is usually .Xr getty 8 ; -.Xr getty +.Nm getty opens and initializes the tty line and executes the -.Xr login +.Xr login 1 program. The -.Xr login +.Nm login program, when a valid user logs in, executes a shell for that user. When this shell dies, either because the user logged out @@ -151,18 +151,18 @@ program wakes up, deletes the user from the .Xr utmp 5 file of current users and records the logout in the -.Xr wtmp +.Xr wtmp 5 file. The cycle is then restarted by .Nm init executing a new -.Xr getty +.Nm getty for the line. .Pp Line status (on, off, secure, getty, or window information) may be changed in the -.Xr ttys +.Xr ttys 5 file without a reboot by sending the signal .Dv SIGHUP to @@ -172,19 +172,19 @@ with the command On receipt of this signal, .Nm init re-reads the -.Xr ttys +.Xr ttys 5 file. When a line is turned off in -.Xr ttys , +.Xr ttys 5 , .Nm init will send a SIGHUP signal to the controlling process for the session associated with the line. For any lines that were previously turned off in the -.Xr ttys +.Xr ttys 5 file and are now on, .Nm init executes a new -.Xr getty +.Nm getty to enable a new login. If the getty or window field for a line is changed, the change takes effect at the end of the current @@ -192,14 +192,14 @@ login session (e.g., the next time .Nm init starts a process on the line). If a line is commented out or deleted from -.Xr ttys , +.Xr ttys 5 , .Nm init will not do anything at all to that line. However, it will complain that the relationship between lines in the -.Xr ttys +.Xr ttys 5 file and records in the -.Xr utmp +.Xr utmp 5 file is out of sync, so this practice is not recommended. .Pp @@ -211,13 +211,13 @@ signal, for example, .Dq Li "kill \-TERM 1" . If there are processes outstanding that are deadlocked (because of hardware or software failure), -.Xr init +.Nm init will not wait for them all to die (which might take forever), but will time out after 30 seconds and print a warning message. .Pp .Nm Init will cease creating new -.Xr getty Ns 's +.Nm getty Ns 's and allow the system to slowly die away, if it is sent a terminal stop .Pq Dv TSTP signal, i.e. @@ -243,7 +243,7 @@ The role of is so critical that if it dies, the system will reboot itself automatically. If, at bootstrap time, the -.Xr init +.Nm init process cannot be located, the system will panic with the message ``panic: "init died (signal %d, exit %d)''. .Sh DIAGNOSTICS @@ -268,7 +268,7 @@ a persistent device error condition. System console device. .It Pa /dev/tty* Terminal ports found in -.Xr ttys . +.Xr ttys 5 . .It Pa /var/run/utmp Record of Current users on the system. .It Pa /var/log/wtmp diff --git a/sbin/ldconfig/ldconfig.8 b/sbin/ldconfig/ldconfig.8 index 9b83224..8f055c0 100644 --- a/sbin/ldconfig/ldconfig.8 +++ b/sbin/ldconfig/ldconfig.8 @@ -27,7 +27,7 @@ .\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. .\" -.\" $Id: ldconfig.8,v 1.6 1994/12/23 22:31:21 nate Exp $ +.\" $Id: ldconfig.8,v 1.7 1995/06/24 10:08:43 asami Exp $ .\" .Dd October 3, 1993 .Dt LDCONFIG 8 @@ -44,16 +44,16 @@ is used to prepare a set of .Dq hints for use by the run-time linker -.Xr ld.so +.Xr ld.so 1 to facilitate quick lookup of shared libraries available in multiple directories. It scans a set of built-in system directories and any .Ar directories specified on the command line (in the given order) looking for shared libraries and stores the results in the file -.Xr /var/run/ld.so.hints +.Pa /var/run/ld.so.hints to forestall the overhead that would otherwise result from the directory search operations -.Xr ld.so +.Xr ld.so 1 would have to perform to load the required shared libraries. .Pp The shared libraries so found will be automatically available for loading @@ -69,12 +69,12 @@ directories where shared libraries might be found. is a .Sq \: separated list of directory paths which are searched by -.Xr ld.so +.Xr ld.so 1 when it needs to load a shared library. It can be viewed as the run-time equivalent of the .Fl L switch of -.Xr ld. +.Xr ld 1 . .Pp .Nm Ldconfig is typically run as part of the boot sequence. @@ -84,13 +84,13 @@ The following options recognized by .Bl -tag -width indent .It Fl m Instead of replacing the contents of -.Xr ld.so.hints +.Pa ld.so.hints with those found in the directories specified, .Dq merge in new entries. .It Fl r Lists the current contents of -.Xr ld.so.hints +.Pa ld.so.hints on the standard output. The hints file will not be modified. .It Fl s Do not scan the built-in system directory @@ -103,9 +103,9 @@ Special care must be taken when loading shared libraries into the address space of .Ev set-user-Id programs. Whenever such a program is run, -.Xr ld.so +.Nm ld.so will only load shared libraries from the -.Ev ld.so.hints +.Pa ld.so.hints file. In particular, the .Ev LD_LIBRARY_PATH is not used to search for libraries. Thus, the role of ldconfig is dual. In @@ -114,13 +114,13 @@ specify the trusted collection of directories from which shared objects can be safely loaded. It is presumed that the set of directories specified to .Nm ldconfig are under control of the system's administrator. -.Xr ld.so +.Nm ld.so further assists set-user-Id programs by erasing the .Ev LD_LIBRARY_PATH from the environment. .Sh FILES -.Xr /var/run/ld.so.hints +.Pa /var/run/ld.so.hints .Sh SEE ALSO .Xr ld 1 , .Xr link 5 diff --git a/share/man/man3/sysexits.3 b/share/man/man3/sysexits.3 index da4169e..4c409e5 100644 --- a/share/man/man3/sysexits.3 +++ b/share/man/man3/sysexits.3 @@ -23,7 +23,7 @@ .\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. .\" -.\" $Id$ +.\" $Id: sysexits.3,v 1.1 1996/03/31 22:33:54 joerg Exp $ .\" .\" " .Dd March 31, 1996 @@ -87,7 +87,7 @@ does not exist in the passwd file. .It Sy EX_OSFILE Pq 72 Some system file (e.g., .Pa /etc/passwd , -.Pa /etc/utmp , +.Pa /var/run/utmp , etc.) does not exist, cannot be opened, or has some sort of error (e.g., syntax error). .It Sy EX_CANTCREAT Pq 73 diff --git a/share/man/man4/icmp.4 b/share/man/man4/icmp.4 index d87772f..01cda3b 100644 --- a/share/man/man4/icmp.4 +++ b/share/man/man4/icmp.4 @@ -62,9 +62,9 @@ is obtained from .Tn ICMP sockets are connectionless, and are normally used with the -.Xr sendto +.Xr sendto 2 and -.Xr recvfrom +.Xr recvfrom 2 calls, though the .Xr connect 2 call may also be used to fix the destination for future diff --git a/share/man/man4/ip.4 b/share/man/man4/ip.4 index acefe0e..6c41c18 100644 --- a/share/man/man4/ip.4 +++ b/share/man/man4/ip.4 @@ -63,7 +63,8 @@ special-purpose applications. .Pp There are several .Tn IP-level -.Xr setsockopt 2 / Ns +.Xr setsockopt 2 +and .Xr getsockopt 2 options. .Dv IP_OPTIONS @@ -115,7 +116,7 @@ option is enabled on a .Dv SOCK_DGRAM socket, the -.Xr recvmsg +.Xr recvmsg 2 call will return the destination .Tn IP address for a @@ -296,9 +297,9 @@ Raw .Tn IP sockets are connectionless, and are normally used with the -.Xr sendto +.Xr sendto 2 and -.Xr recvfrom +.Xr recvfrom 2 calls, though the .Xr connect 2 call may also be used to fix the destination for future diff --git a/share/man/man4/netintro.4 b/share/man/man4/netintro.4 index 7a09016..79a0179 100644 --- a/share/man/man4/netintro.4 +++ b/share/man/man4/netintro.4 @@ -174,10 +174,10 @@ certain interfaces such as the loopback interface, do not. .Pp The following -.Xr ioctl +.Xr ioctl 2 calls may be used to manipulate network interfaces. The -.Xr ioctl +.Fn ioctl is made on a socket (typically of type .Dv SOCK_DGRAM ) in the desired domain. @@ -218,7 +218,7 @@ Set point to point address for protocol family and interface. Set broadcast address for protocol family and interface. .El .Pp -.Xr Ioctl +.Fn Ioctl requests to obtain addresses and requests both to set and retrieve other data are still fully supported and use the @@ -263,9 +263,9 @@ to each family (replacing each sockaddr by one of the family-specific type). Where the sockaddr itself is larger than the default size, one needs to modify the -.Xr ioctl +.Fn ioctl identifier itself to include the total size, as described in -.Xr ioctl . +.Fn ioctl . .It Dv SIOCDIFADDR This requests deletes the specified address from the list associated with an interface. It also uses the diff --git a/share/man/man4/pty.4 b/share/man/man4/pty.4 index dd982c3..b8b6b87 100644 --- a/share/man/man4/pty.4 +++ b/share/man/man4/pty.4 @@ -42,7 +42,7 @@ .Op Ar count .Sh DESCRIPTION The -.Xr pty +.Nm pty driver provides support for a device-pair termed a .Em pseudo terminal . A pseudo terminal is a pair of character devices, a @@ -92,7 +92,7 @@ mode. Packet mode is enabled by specifying (by reference) a nonzero parameter and disabled by specifying (by reference) a zero parameter. When applied to the master side of a pseudo terminal, each subsequent -.Xr read +.Xr read 2 from the terminal will return data written on the slave part of the pseudo terminal preceded by a zero byte (symbolically defined as @@ -140,7 +140,7 @@ used by other similar programs. .El .It Dv TIOCUCNTL Enable/disable a mode that allows a small number of simple user -.Xr ioctl +.Xr ioctl 2 commands to be passed through the pseudo-terminal, using a protocol similar to that of .Dv TIOCPKT . @@ -154,12 +154,12 @@ by specifying (by reference) a nonzero parameter and disabled by specifying (by reference) a zero parameter. Each subsequent -.Xr read +.Xr read 2 from the master side will return data written on the slave part of the pseudo terminal preceded by a zero byte, or a single byte reflecting a user control operation on the slave side. A user control command consists of a special -.Xr ioctl +.Xr ioctl 2 operation with no data; the command is given as .Dv UIOCCMD Ns (n) , where @@ -168,17 +168,17 @@ is a number in the range 1-255. The operation value .Ar n will be received as a single byte on the next -.Xr read +.Xr read 2 from the master side. The -.Xr ioctl +.Xr ioctl 2 .Dv UIOCCMD Ns (0) is a no-op that may be used to probe for the existence of this facility. As with .Dv TIOCPKT mode, command operations may be detected with a -.Xr select +.Xr select 2 for exceptional conditions. .It Dv TIOCREMOTE A mode for the master half of a pseudo terminal, independent diff --git a/share/man/man4/su.4 b/share/man/man4/su.4 index b89842f..dc84603 100644 --- a/share/man/man4/su.4 +++ b/share/man/man4/su.4 @@ -8,7 +8,7 @@ .Nm device-driver su .Sh DESCRIPTION The -.Xr su +.Nm su driver provides support for a process to address arbitrary locations on the scsi bus. Minor numbers are mapped 1:1 to bus:target:lun. The lowest three bits being LUN diff --git a/share/man/man4/tcp.4 b/share/man/man4/tcp.4 index 5aecf1d..522e037 100644 --- a/share/man/man4/tcp.4 +++ b/share/man/man4/tcp.4 @@ -30,7 +30,7 @@ .\" SUCH DAMAGE. .\" .\" From: @(#)tcp.4 8.1 (Berkeley) 6/5/93 -.\" $Id: tcp.4,v 1.3 1995/02/15 03:30:54 wollman Exp $ +.\" $Id: tcp.4,v 1.4 1995/02/15 22:07:27 wollman Exp $ .\" .Dd February 14, 1995 .Dt TCP 4 @@ -150,9 +150,9 @@ will set the .Dq push bit and begin transmission immediately (if permitted) at the end of every user call to -.Xr write +.Xr write 2 or -.Xr writev . +.Xr writev 2 . The .Dv TCP_NOPUSH option is provided to allow servers to easily make use of Transaction @@ -165,7 +165,7 @@ or the internal send buffer is filled. .El .Pp The option level for the -.Xr setsockopt +.Xr setsockopt 2 call is the protocol number for .Tn TCP , available from diff --git a/share/man/man4/termios.4 b/share/man/man4/termios.4 index 1722286..519c82e 100644 --- a/share/man/man4/termios.4 +++ b/share/man/man4/termios.4 @@ -85,6 +85,7 @@ is created when a user logs in, and the login terminal is setup to be the controlling terminal; all processes spawned from that login shell are in the same session, and inherit the controlling terminal. +.Pp A job control shell operating interactively (that is, reading commands from a terminal) normally groups related processes together by placing them into the @@ -199,7 +200,7 @@ the writing process is orphaned, and the writing process is not ignoring or blocking .Dv SIGTTOU , the -.Xr write +.Xr write 2 returns -1 with errno set to .Er Dv EIO @@ -252,9 +253,9 @@ canonical or noncanonical mode. Another dependency is whether the .Dv O_NONBLOCK flag is set by -.Xr open() +.Xr open 2 or -.Xr fcntl() . +.Xr fcntl 2 . If the .Dv O_NONBLOCK flag is clear, then the read request is @@ -355,7 +356,7 @@ process the bytes received. .Dv MIN represents the minimum number of bytes that should be received when the -.Xr read +.Xr read 2 function successfully returns. .Dv TIME is a timer of 0.1 second @@ -402,8 +403,11 @@ and .Dv TIME mechanisms are activated by the receipt of the first byte, or a signal is received. If -data is in the buffer at the time of the read(), the result is as -if data had been received immediately after the read(). +data is in the buffer at the time of the +.Fn read , +the result is as +if data had been received immediately after the +.Fn read . .Ss "Case B: MIN > 0, TIME = 0" In this case, since the value of .Dv TIME @@ -451,7 +455,8 @@ field (see the .Sx "Output Modes section). The implementation may provide a buffering mechanism; as such, when a call to -write() completes, all of the bytes written have been scheduled for +.Fn write +completes, all of the bytes written have been scheduled for transmission to the device, but the transmission will not necessarily have been completed. .\" See also .Sx "6.4.2" for the effects of @@ -532,7 +537,8 @@ is discarded. Thus, if there are no bytes waiting (that is, the .Dv EOF occurred at the beginning of a line), a byte -count of zero is returned from the read(), +count of zero is returned from the +.Fn read , representing an end-of-file indication. If .Dv ICANON is @@ -653,7 +659,9 @@ character, except that the .Dv SIGTSTP signal is delivered when one of the processes -in the foreground process group issues a read() to the +in the foreground process group issues a +.Fn read +to the controlling terminal. .It Dv LNEXT Special character on input and is recognized if the @@ -712,7 +720,9 @@ the terminal, the signal is sent to the controlling process associated with the terminal. Unless other arrangements have been made, this causes the controlling process to terminate. -Any subsequent call to the read() function returns the value zero, +Any subsequent call to the +.Fn read +function returns the value zero, indicating end of file. Thus, processes that read a terminal file and test for end-of-file can terminate appropriately after a disconnect. @@ -726,7 +736,9 @@ disconnect. .\" .Pf [ Dv EIO .\" ] is returned. Any -subsequent write() to the terminal device returns -1, with +subsequent +.Fn write +to the terminal device returns -1, with .Va errno set to .Er EIO , @@ -958,7 +970,9 @@ is set and the input queue is full, subsequent input shall cause an character to be transmitted to the the output queue. .Pp -The initial input control value after open() is implementation defined. +The initial input control value after +.Fn open +is implementation defined. .Ss Output Modes Values of the .Fa c_oflag @@ -1098,13 +1112,17 @@ status lines. If is clear, the modem status lines are monitored. .Pp -Under normal circumstances, a call to the open() function waits for +Under normal circumstances, a call to the +.Fn open +function waits for the modem connection to complete. However, if the .Dv O_NONBLOCK flag is set or if .Dv CLOCAL -has been set, the open() function returns +has been set, the +.Fn open +function returns immediately without waiting for the connection. .Pp The @@ -1406,6 +1424,8 @@ entries of the array. .Pp The initial values of the flags and control characters -after open() is set according to +after +.Fn open +is set according to the values in the header .Aq Pa sys/ttydefaults.h . diff --git a/share/man/man4/udp.4 b/share/man/man4/udp.4 index 939866b..900aa70 100644 --- a/share/man/man4/udp.4 +++ b/share/man/man4/udp.4 @@ -52,9 +52,9 @@ protocol family. .Tn UDP sockets are connectionless, and are normally used with the -.Xr sendto +.Xr sendto 2 and -.Xr recvfrom +.Xr recvfrom 2 calls, though the .Xr connect 2 call may also be used to fix the destination for future diff --git a/share/man/man4/uk.4 b/share/man/man4/uk.4 index e69c527..24e87cc 100644 --- a/share/man/man4/uk.4 +++ b/share/man/man4/uk.4 @@ -8,7 +8,7 @@ .Nm device uk .Sh DESCRIPTION The -.Xr uk +.Nm uk driver provides support for a process to address devices on the scsi bus for which there is no configured driver. diff --git a/share/man/man4/worm.4 b/share/man/man4/worm.4 index c3a18da..e10075a 100644 --- a/share/man/man4/worm.4 +++ b/share/man/man4/worm.4 @@ -32,7 +32,7 @@ .\" USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH .\" DAMAGE. .\" -.\" $Id: worm.4,v 1.2 1996/01/27 17:55:54 joerg Exp $ +.\" $Id: worm.4,v 1.3 1996/01/30 13:51:19 mpp Exp $ .\" .Dd January 27, 1996 .Dt WORM 4 @@ -45,7 +45,7 @@ .Cd disk worm0 target 5 lun 0 .Sh DESCRIPTION The -.Xr worm +.Nm worm driver provides support for a .Em SCSI write-once device, in particular for a CD-R recording device. The diff --git a/share/man/man4/yp.4 b/share/man/man4/yp.4 index 576338d..ac78f40 100644 --- a/share/man/man4/yp.4 +++ b/share/man/man4/yp.4 @@ -26,7 +26,7 @@ .\" SUCH DAMAGE. .\" .\" from: @(#)yp.8 1.0 (deraadt) 4/26/93 -.\" $Id: yp.4,v 1.4 1995/09/02 04:20:01 wpaul Exp $ +.\" $Id: yp.4,v 1.5 1996/01/30 13:51:21 mpp Exp $ .\" .Dd April 5, 1993 .Dt YP 4 @@ -51,7 +51,7 @@ entries through the functions and .Xr ethers 3 . The -.Nm bootparamd +.Xr bootparamd 8 daemon makes direct NIS library calls since there are no functions in the standard C library for reading bootparams. NIS support for the hosts, services and rpc databases is enabled by @@ -69,7 +69,7 @@ subsystem is started automatically in if it has been initialized in .Pa /etc/sysconfig and if the directory -.Nm /var/yp +.Pa /var/yp exists (which it does in the default distribution). The default NIS domain must also be set with the .Xr domainname 1 @@ -140,7 +140,7 @@ updated by the master. .El .Pp An NIS client establishes what is called a -.Nm binding +.Em binding to a particular NIS server using the .Xr ypbind 8 daemon. @@ -180,38 +180,41 @@ is designed to handle, most of which are implemented as functions within the standard C library: .Bl -bullet -offset indent .It -.Nm yp_order() +.Fn yp_order -- check the creation date of a particular map .It -.Nm yp_master() +.Fn yp_master -- obtain the name of the NIS master server for a given map/domain .It -.Nm yp_match() +.Fn yp_match -- lookup the data corresponding to a given in key in a particular map/domain .It -.Nm yp_first() +.Fn yp_first -- obtain the first key/data pair in a particular map/domain .It -.Nm yp_next() +.Fn yp_next -- pass .Xr ypserv 8 a key in a particular map/domain and have it return the -key/data pair immediately following it (yp_first() and yp_next() +key/data pair immediately following it (the functions +.Fn yp_first +and +.Fn yp_next can be used to do a sequential search of an NIS map) .It -.Nm yp_all() +.Fn yp_all -- retrieve the entire contents of a map .El .Pp There are a few other requests which -.Xr ypserv +.Xr ypserv 8 is capable of handling (i.e. acknowledge whether or not you can handle a particular domain (YPPROC_DOMAIN), or acknowledge only if you can handle the domain and be silent otherwise (YPPROC_DOMAIN_NONACK)) but these requests are usually generated only by -.Xr ypbind +.Xr ypbind 8 and are not meant to be used by standard utilities. .Pp On networks with a large number of hosts, it is often a good idea to @@ -268,7 +271,7 @@ is specially designed to provided enhanced security (compared to other NIS implementations) when used exclusively with FreeBSD client systems. The FreeBSD password database system (which is derived directly form 4.4BSD) includes support for -.Nm shadow passwords . +.Em "shadow passwords" . The standard password database does not contain users' encrypted passwords: these are instead stored (along with other information) is a separate database which is accessible only by the super-user. @@ -355,7 +358,8 @@ and functions do not yet have NIS support. Fortunately, these files don't need to be updated that often. .Pp -Many more manual pages should be written, especially ypclnt(3). +Many more manual pages should be written, especially +.Xr ypclnt 3 . For the time being, seek out a local Sun machine and read the manuals for there. .Pp diff --git a/share/man/man5/fs.5 b/share/man/man5/fs.5 index 7b674de..1c31f2b 100644 --- a/share/man/man5/fs.5 +++ b/share/man/man5/fs.5 @@ -292,7 +292,7 @@ These blocks are read in from in addition to the super-block. .Pp .Sy N.B.: -.Xr sizeof Pq Fa struct csum +.Fn sizeof "struct csum" must be a power of two in order for the .Fn fs_cs diff --git a/share/man/man5/fstab.5 b/share/man/man5/fstab.5 index 27a73dd..a1bf7c0 100644 --- a/share/man/man5/fstab.5 +++ b/share/man/man5/fstab.5 @@ -166,7 +166,7 @@ is used for these filesystems by the .Xr dump 8 command to determine which filesystems need to be dumped. If the fifth field is not present, a value of zero is returned and -.Xr dump +.Nm dump will assume that the filesystem does not need to be dumped. .Pp The sixth field, @@ -185,7 +185,7 @@ but filesystems on different drives will be checked at the same time to utilize parallelism available in the hardware. If the sixth field is not present or zero, a value of zero is returned and -.Xr fsck +.Xr fsck 8 will assume that the filesystem does not need to be checked. .Bd -literal #define FSTAB_RW "rw" /* read-write device */ diff --git a/share/man/man5/link.5 b/share/man/man5/link.5 index 2d86997..c7e02d1 100644 --- a/share/man/man5/link.5 +++ b/share/man/man5/link.5 @@ -26,7 +26,7 @@ .\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. .\" -.\" $Id: link.5,v 1.3 1996/01/20 07:29:06 mpp Exp $ +.\" $Id: link.5,v 1.4 1996/01/30 13:51:35 mpp Exp $ .\" .Dd October 23, 1993 .Dt LINK 5 @@ -56,7 +56,7 @@ The collection of data structures described here will be referred to as the .Em Run-time Relocation Section (RRS) and is embedded in the standard text and data segments of the dynamically linked program or shared object image as the existing -.Xr a.out +.Xr a.out 5 format offers no room for it elsewhere. .Pp Several utilities cooperate to ensure that the task of getting a program @@ -118,7 +118,11 @@ struct _dynamic { .Bl -tag -width d_version .It Fa d_version This field provides for different versions of the dynamic linking -implementation. The current version numbers understood by ld and ld.so are +implementation. The current version numbers understood by +.Xr ld 1 +and +.Xr ld.so 1 +are .Em LD_VERSION_SUN (3), which is used by the SunOS 4.x releases, and .Em LD_VERSION_BSD (8), @@ -160,7 +164,7 @@ struct section_dispatch_table { .Bl -tag -width sdt_filler1 .It Fa sdt_loaded A pointer to the first link map loaded (see below). This field is set by -.Xr ld.so. +.Nm ld.so .It Fa sdt_sods The start of a (linked) list of shared object descriptors needed by .Em this @@ -231,7 +235,9 @@ The offset in the text segment of a string describing this link object. .It Fa sod_library If set, .Fa sod_name -specifies a library that is to be searched for by ld.so. The path name +specifies a library that is to be searched for by +.Nm ld.so . +The path name is obtained by searching a set of directories .Po see also @@ -316,7 +322,7 @@ struct nzlist { .It Fa nlist .Po see -.Xr nlist 5 +.Xr nlist 3 .Pc . .It Fa nz_size The size of the data represented by this symbol. @@ -372,7 +378,8 @@ The symbol description. .It Fa rt_next Virtual address of next rt_symbol. .It Fa rt_link -Next in hash bucket. Used by internally by ld.so. +Next in hash bucket. Used by internally by +.Nm ld.so . .It Fa rt_srcaddr Location of the source of initialized data within a shared object. .It Fa rt_smp @@ -429,9 +436,11 @@ may be interested in. .Pp The .Em ld_entry -structure defines a set of service routines within ld.so. See -.Xr libdl.a -for more information. +structure defines a set of service routines within +.Nm ld.so . +.\" See +.\" .Xr libdl.a +.\" for more information. .Bd -literal -offset indent struct ld_entry { void *(*dlopen)(char *, int); @@ -443,7 +452,8 @@ struct ld_entry { The .Fa crt_ldso -structure defines the interface between the start-up code in crt0 and ld.so. +structure defines the interface between the start-up code in crt0 and +.Nm ld.so . .Bd -literal -offset indent struct crt_ldso { int crt_ba; @@ -463,13 +473,16 @@ struct crt_ldso { .Ed .Bl -tag -width crt_dzfd .It Fa crt_ba -The virtual address at which ld.so was loaded by crt0. +The virtual address at which +.Nm ld.so +was loaded by crt0. .It Fa crt_dzfd On SunOS systems, this field contains an open file descriptor to -.Dq /dev/zero +.Dq Pa /dev/zero used to get demand paged zeroed pages. On FreeBSD systems it contains -1. .It Fa crt_ldfd -Contains an open file descriptor that was used by crt0 to load ld.so. +Contains an open file descriptor that was used by crt0 to load +.Nm ld.so . .It Fa crt_dp A pointer to main's .Fa _dynamic @@ -492,8 +505,10 @@ The and .Fa hints_bucket structures define the layout of the library hints, normally found in -.Dq /var/run/ld.so.hints, -which is used by ld.so to quickly locate the shared object images in the +.Dq Pa /var/run/ld.so.hints , +which is used by +.Nm ld.so +to quickly locate the shared object images in the filesystem. The organization of the hints file is not unlike that of an .Dq a.out diff --git a/share/man/man5/networks.5 b/share/man/man5/networks.5 index f8f4c4e..0e51671 100644 --- a/share/man/man5/networks.5 +++ b/share/man/man5/networks.5 @@ -39,7 +39,7 @@ .Nd network name data base .Sh DESCRIPTION The -.Xr networks +.Nm networks file contains information regarding the known networks which comprise the .Tn DARPA diff --git a/share/man/man5/printcap.5 b/share/man/man5/printcap.5 index cd2cd119..05fba66 100644 --- a/share/man/man5/printcap.5 +++ b/share/man/man5/printcap.5 @@ -52,7 +52,7 @@ file every time it is used, allowing dynamic addition and deletion of printers. Each entry in the data base is used to describe one printer. This data base may not be substituted for, as is possible for -.Xr termcap , +.Xr termcap 5 , because it may allow accounting to be bypassed. .Pp The default printer is normally @@ -167,7 +167,7 @@ flag is passed only if the .Fl l flag (pass control characters literally) is specified to -.Xr lpr . +.Xr lpr 1 . The .Ar Width function @@ -249,8 +249,8 @@ and must not ignore .Sh LOGGING Error messages generated by the line printer programs themselves (that is, the -.Xr lp Ns * -programs) +.Xr lpd 8 +and related programs) are logged by .Xr syslog 3 using the @@ -263,7 +263,7 @@ are sent to the corresponding .Cm lf file. The filters may, of course, use -.Xr syslog +.Xr syslog 8 themselves. .Pp Error messages sent to the console have a carriage return and a line diff --git a/share/man/man5/remote.5 b/share/man/man5/remote.5 index 27c83f6..1a0a33e 100644 --- a/share/man/man5/remote.5 +++ b/share/man/man5/remote.5 @@ -46,7 +46,7 @@ file which is structured somewhat like the .Xr termcap 5 file. Each line in the file provides a description for a single -.Xr system . +.Em system . Fields are separated by a colon (``:''). Lines ending in a \e character with an immediately following newline are continued on the next line. @@ -59,17 +59,17 @@ name followed by a `#' sign indicates a following numeric value. .Pp Entries named ``tip*'' and ``cu*'' are used as default entries by -.Xr tip , +.Xr tip 1 , and the -.Xr cu +.Xr cu 1 interface to -.Xr tip , +.Nm tip , as follows. When -.Xr tip +.Nm tip is invoked with only a phone number, it looks for an entry of the form ``tip300'', where 300 is the baud rate with which the connection is to be made. When the -.Xr cu +.Nm cu interface is used, entries of the form ``cu300'' are used. .Sh CAPABILITIES Capabilities are either strings (str), numbers (num), or boolean @@ -122,7 +122,7 @@ The default is .Dv NULL . `~' escapes are only recognized by -.Xr tip +.Nm tip after one of the characters in `el', or after a carriage-return. .It Cm \&fs @@ -145,7 +145,7 @@ Output end-of-file string. The default is .Dv NULL . When -.Xr tip +.Nm tip is transferring a file, this string is sent at end-of-file. .It Cm \&pa @@ -160,7 +160,7 @@ is even parity. Telephone number(s) for this host. If the telephone number field contains an @ sign, -.Xr tip +.Nm tip searches the file .Pa /etc/phones file for a list of telephone numbers; diff --git a/share/man/man5/utmp.5 b/share/man/man5/utmp.5 index a3ac4b0..b25b4da 100644 --- a/share/man/man5/utmp.5 +++ b/share/man/man5/utmp.5 @@ -90,7 +90,7 @@ struct utmp { .Ed .Pp Each time a user logs in, the -.Xr login +.Xr login 1 program looks up the user's .Tn UID in the file @@ -102,7 +102,7 @@ are written to the standard output. (Providing the login is not see .Xr login 1 . ) The -.Xr login +.Nm login program then records the new login time in the file .Nm lastlog . .Pp diff --git a/share/man/man7/clocks.7 b/share/man/man7/clocks.7 index 7c3babf..fa6abe5 100644 --- a/share/man/man7/clocks.7 +++ b/share/man/man7/clocks.7 @@ -25,7 +25,7 @@ .\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. .\" -.\" $Id: clocks.7,v 1.1 1996/04/05 08:51:22 joerg Exp $ +.\" $Id: clocks.7,v 1.2 1996/04/07 21:12:10 mpp Exp $ .\" " .Dd April 1, 1996 .Os @@ -52,8 +52,11 @@ happens to be 128. It isn't directly available to applications. The clock reported by .Xr clock 3 . This is a virtual clock with a frequency that happens to be 128. It's -actual frequency is given by the macro CLOCKS_PER_SEC. Note that -CLOCKS_PER_SEC may be floating point. Don't use +actual frequency is given by the macro +.Dv CLOCKS_PER_SEC . +Note that +.Dv CLOCKS_PER_SEC +may be floating point. Don't use .Fn clock in new programs under FreeBSD. It is feeble compared with .Xr getrusage 2 . @@ -64,13 +67,15 @@ and throwing away information and resolution. The clock reported by .Xr times 3 . This is a virtual clock with a frequency that happens to be 128. It's -actual frequency is given by the macro CLK_TCK (deprecated; don't use) -and by +actual frequency is given by the macro +.Dv CLK_TCK +(deprecated; don't use) and by .Fn sysconf SC_CLK_TCK and by .Xr sysctl 3 . -Note that its frequency may be different from CLOCKS_PER_SEC. Don't -use +Note that its frequency may be different from +.Dv CLOCKS_PER_SEC . +Don't use .Xr times 3 in new programs under FreeBSD. It is feeble compared with .Xr gettimeofday 2 diff --git a/share/man/man7/environ.7 b/share/man/man7/environ.7 index e969e3c..1b22221 100644 --- a/share/man/man7/environ.7 +++ b/share/man/man7/environ.7 @@ -54,7 +54,8 @@ The size of the block units used by several commands, most notably .Xr du 1 and .Xr ls 1 . -BLOCKSIZE may be specified in units of a byte by specifying a number, +.Ev BLOCKSIZE +may be specified in units of a byte by specifying a number, in units of a kilobyte by specifying a number followed by ``K'' or ``k'', in units of a megabyte by specifying a number followed by ``M'' or ``m'' and in units of a gigabyte by specifying a number followed @@ -72,9 +73,9 @@ A user's login directory, set by from the password file .Xr passwd 5 . .It Ev LANG -This variable configure all programs which use +This variable configures all programs which use .Xr setlocale 3 -to specified locale. +to use the specified locale. .It Ev PATH The sequence of directories, separated by colons, searched by .Xr csh 1 , @@ -82,7 +83,8 @@ The sequence of directories, separated by colons, searched by .Xr system 3 , .Xr execvp 3 , etc, when looking for an executable file. -PATH is set to ``/usr/bin:/bin'' initially by +.Ev PATH +is set to ``/usr/bin:/bin'' initially by .Xr login 1 . .It Ev PRINTER The name of the default printer to be used by @@ -103,7 +105,9 @@ which may exploit special terminal capabilities. See .Pq Xr termcap 5 for a list of terminal types. .It Ev TERMCAP -The string describing the terminal in TERM, or, if +The string describing the terminal in +.Ev TERM , +or, if it begins with a '/', the name of the termcap file. See .Ev TERMPATH @@ -134,7 +138,7 @@ Setting this variable will make them use another directory. .It Ev TZ The timezone to use when displaying dates. The normal format is a pathname relative to -.Dq /usr/share/zoneinfo . +.Dq Pa /usr/share/zoneinfo . For example, the command .Dq env TZ=US/Pacific date displays the current time in California. diff --git a/share/man/man7/hier.7 b/share/man/man7/hier.7 index 3013278..c7f1eb6 100644 --- a/share/man/man7/hier.7 +++ b/share/man/man7/hier.7 @@ -76,7 +76,7 @@ see .It Li mtree/ mtree configuration files; see -.Xr mtree 1 +.Xr mtree 8 .It Li namedb/ named configuration files; see diff --git a/share/man/man8/rc.8 b/share/man/man8/rc.8 index 1e953a6..162aa3c 100644 --- a/share/man/man8/rc.8 +++ b/share/man/man8/rc.8 @@ -76,7 +76,7 @@ and clears the scratch directory .Pp .Nm Rc.local is executed immediately before any other commands after a successful -.Xr fsck . +.Nm fsck . Normally, the first commands placed in the .Nm rc.local file define the machine's name, using diff --git a/share/man/man8/yp.8 b/share/man/man8/yp.8 index 576338d..ac78f40 100644 --- a/share/man/man8/yp.8 +++ b/share/man/man8/yp.8 @@ -26,7 +26,7 @@ .\" SUCH DAMAGE. .\" .\" from: @(#)yp.8 1.0 (deraadt) 4/26/93 -.\" $Id: yp.4,v 1.4 1995/09/02 04:20:01 wpaul Exp $ +.\" $Id: yp.4,v 1.5 1996/01/30 13:51:21 mpp Exp $ .\" .Dd April 5, 1993 .Dt YP 4 @@ -51,7 +51,7 @@ entries through the functions and .Xr ethers 3 . The -.Nm bootparamd +.Xr bootparamd 8 daemon makes direct NIS library calls since there are no functions in the standard C library for reading bootparams. NIS support for the hosts, services and rpc databases is enabled by @@ -69,7 +69,7 @@ subsystem is started automatically in if it has been initialized in .Pa /etc/sysconfig and if the directory -.Nm /var/yp +.Pa /var/yp exists (which it does in the default distribution). The default NIS domain must also be set with the .Xr domainname 1 @@ -140,7 +140,7 @@ updated by the master. .El .Pp An NIS client establishes what is called a -.Nm binding +.Em binding to a particular NIS server using the .Xr ypbind 8 daemon. @@ -180,38 +180,41 @@ is designed to handle, most of which are implemented as functions within the standard C library: .Bl -bullet -offset indent .It -.Nm yp_order() +.Fn yp_order -- check the creation date of a particular map .It -.Nm yp_master() +.Fn yp_master -- obtain the name of the NIS master server for a given map/domain .It -.Nm yp_match() +.Fn yp_match -- lookup the data corresponding to a given in key in a particular map/domain .It -.Nm yp_first() +.Fn yp_first -- obtain the first key/data pair in a particular map/domain .It -.Nm yp_next() +.Fn yp_next -- pass .Xr ypserv 8 a key in a particular map/domain and have it return the -key/data pair immediately following it (yp_first() and yp_next() +key/data pair immediately following it (the functions +.Fn yp_first +and +.Fn yp_next can be used to do a sequential search of an NIS map) .It -.Nm yp_all() +.Fn yp_all -- retrieve the entire contents of a map .El .Pp There are a few other requests which -.Xr ypserv +.Xr ypserv 8 is capable of handling (i.e. acknowledge whether or not you can handle a particular domain (YPPROC_DOMAIN), or acknowledge only if you can handle the domain and be silent otherwise (YPPROC_DOMAIN_NONACK)) but these requests are usually generated only by -.Xr ypbind +.Xr ypbind 8 and are not meant to be used by standard utilities. .Pp On networks with a large number of hosts, it is often a good idea to @@ -268,7 +271,7 @@ is specially designed to provided enhanced security (compared to other NIS implementations) when used exclusively with FreeBSD client systems. The FreeBSD password database system (which is derived directly form 4.4BSD) includes support for -.Nm shadow passwords . +.Em "shadow passwords" . The standard password database does not contain users' encrypted passwords: these are instead stored (along with other information) is a separate database which is accessible only by the super-user. @@ -355,7 +358,8 @@ and functions do not yet have NIS support. Fortunately, these files don't need to be updated that often. .Pp -Many more manual pages should be written, especially ypclnt(3). +Many more manual pages should be written, especially +.Xr ypclnt 3 . For the time being, seek out a local Sun machine and read the manuals for there. .Pp diff --git a/usr.bin/ar/ar.5 b/usr.bin/ar/ar.5 index 29c8f8c..37220a8 100644 --- a/usr.bin/ar/ar.5 +++ b/usr.bin/ar/ar.5 @@ -126,8 +126,8 @@ The fields are the object name (14 characters), the file last modification time (type long), the user and group id's (each type char), the file mode (type int) and the file size (type long). Files were padded to an even number of bytes. -For more information on converting from this format see -.Xr arcv 8 . +.\" For more information on converting from this format see +.\" .Xr arcv 8 . .Pp The current archive format (without support for long character names and names with embedded spaces) was introduced in diff --git a/usr.bin/key/key.1 b/usr.bin/key/key.1 index d9da463..7399233 100644 --- a/usr.bin/key/key.1 +++ b/usr.bin/key/key.1 @@ -41,7 +41,7 @@ The default is one. .SH SEE ALSO .BR skey(1), .BR keyinit(1), -.BR keysu(1), +.\" .BR keysu(1), .BR keyinfo(1) .SH AUTHOR Command by Phil Karn, Neil M. Haller, John S. Walden diff --git a/usr.bin/tip/tip/modems.5 b/usr.bin/tip/tip/modems.5 index f6abba3..f23e7d9 100644 --- a/usr.bin/tip/tip/modems.5 +++ b/usr.bin/tip/tip/modems.5 @@ -46,7 +46,7 @@ file which is structured somewhat like the .Xr termcap 5 file. Each line in the file provides a description for a single -.Xr modem . +.Em modem . Fields are separated by a colon (``:''). Lines ending in a \e character with an immediately following newline are continued on the next line. @@ -58,16 +58,16 @@ field name followed by an `=' sign indicates a string value follows. A field name followed by a `#' sign indicates a following numeric value. .Pp When -.Xr tip +.Xr tip 1 is invoked, an entry for a remote system is looked up in the .Pa /etc/remote database. If the entry includes an "ACU" type capability (abbreviated at), -.Xr tip +.Xr tip 1 looks up the specified modem in .Pa /etc/modems. If a modem entry is found, the corresponding capabilities determine how -.Xr tip +.Xr tip 1 programs the modem when connecting to and disconnecting from the remote system. .Sh CAPABILITIES diff --git a/usr.bin/ul/ul.1 b/usr.bin/ul/ul.1 index 701797a..4ee0ff8 100644 --- a/usr.bin/ul/ul.1 +++ b/usr.bin/ul/ul.1 @@ -89,15 +89,16 @@ specified in or as set during the login process by the user in their .Pa login file (see -.Xr setenv 1 ) . +.Xr environ 7 ) . .El .Sh SEE ALSO .Xr man 1 , .Xr nroff 1 , .Xr colcrt 1 .Sh BUGS -.Xr Nroff -usually outputs a series of backspaces and underlines intermixed +The +.Xr nroff 1 +command usually outputs a series of backspaces and underlines intermixed with the text to indicate underlining. No attempt is made to optimize the backward motion. .Sh HISTORY diff --git a/usr.sbin/amd/amq/amq.8 b/usr.sbin/amd/amq/amq.8 index f5cb681..edbdaca 100644 --- a/usr.sbin/amd/amq/amq.8 +++ b/usr.sbin/amd/amq/amq.8 @@ -37,7 +37,7 @@ .\" .\" @(#)amq.8 8.3 (Berkeley) 4/18/94 .\" -.\" $Id: amq.8,v 1.1.1.1 1994/05/26 05:22:04 rgrimes Exp $ +.\" $Id: amq.8,v 1.2 1996/01/20 07:28:37 mpp Exp $ .\" .Dd March 16, 1991 .Dt AMQ 8 @@ -94,12 +94,12 @@ Request the automounter to unmount the named filesystems instead of providing information about them. Unmounts are requested, not forced. They merely cause the mounted filesystem to timeout, which will be picked up by -.Xr amd Ns \'s +.Nm amd Ns \'s main scheduler thus causing the normal timeout action to be taken. .It Fl v Request the automounter to provide version information. This is a subset of the information provided by -.Xr amd Ns \'s Fl v +.Nm amd Ns \'s Fl v option. .It Fl M Request automounter to add the given map entry to the root map and then diff --git a/usr.sbin/lpr/lpc/lpc.8 b/usr.sbin/lpr/lpc/lpc.8 index a786adc..63c4f0d 100644 --- a/usr.sbin/lpr/lpc/lpc.8 +++ b/usr.sbin/lpr/lpc/lpc.8 @@ -85,7 +85,7 @@ or, if no argument is given, a list of the recognized commands. .It Ic abort No {\ all\ |\ printer\ } Terminate an active spooling daemon on the local host immediately and then disable printing (preventing new daemons from being started by -.Xr lpr ) +.Xr lpr 1 ) for the specified printers. .Pp .It Ic clean No {\ all\ |\ printer\ } @@ -96,7 +96,7 @@ from the specified printer queue(s) on the local machine. .It Ic disable No {\ all\ |\ printer\ } Turn the specified printer queues off. This prevents new printer jobs from being entered into the queue by -.Xr lpr . +.Xr lpr 1 . .Pp .It Ic down No {\ all\ |\ printer\ } message ... Turn the specified printer queue off, disable printing and put @@ -122,7 +122,7 @@ Exit from lpc. Attempt to start a new printer daemon. This is useful when some abnormal condition causes the daemon to die unexpectedly, leaving jobs in the queue. -.Xr Lpq +.Xr Lpq 1 will report that there is no daemon present when this condition occurs. If the user is the super-user, try to abort the current daemon first (i.e., kill and restart a stuck daemon). diff --git a/usr.sbin/lpr/lpr/lpr.1 b/usr.sbin/lpr/lpr/lpr.1 index b3181c2..349c0c8 100644 --- a/usr.sbin/lpr/lpr/lpr.1 +++ b/usr.sbin/lpr/lpr/lpr.1 @@ -88,8 +88,7 @@ The files are assumed to contain data from .It Fl p Use .Xr pr 1 -to format the files (equivalent to -.Xr print ) . +to format the files. .It Fl t The files are assumed to contain data from .Xr troff 1 diff --git a/usr.sbin/lpr/lpr/printcap.5 b/usr.sbin/lpr/lpr/printcap.5 index cd2cd119..05fba66 100644 --- a/usr.sbin/lpr/lpr/printcap.5 +++ b/usr.sbin/lpr/lpr/printcap.5 @@ -52,7 +52,7 @@ file every time it is used, allowing dynamic addition and deletion of printers. Each entry in the data base is used to describe one printer. This data base may not be substituted for, as is possible for -.Xr termcap , +.Xr termcap 5 , because it may allow accounting to be bypassed. .Pp The default printer is normally @@ -167,7 +167,7 @@ flag is passed only if the .Fl l flag (pass control characters literally) is specified to -.Xr lpr . +.Xr lpr 1 . The .Ar Width function @@ -249,8 +249,8 @@ and must not ignore .Sh LOGGING Error messages generated by the line printer programs themselves (that is, the -.Xr lp Ns * -programs) +.Xr lpd 8 +and related programs) are logged by .Xr syslog 3 using the @@ -263,7 +263,7 @@ are sent to the corresponding .Cm lf file. The filters may, of course, use -.Xr syslog +.Xr syslog 8 themselves. .Pp Error messages sent to the console have a carriage return and a line diff --git a/usr.sbin/lptcontrol/lptcontrol.8 b/usr.sbin/lptcontrol/lptcontrol.8 index 4a02390..34306d5 100644 --- a/usr.sbin/lptcontrol/lptcontrol.8 +++ b/usr.sbin/lptcontrol/lptcontrol.8 @@ -11,7 +11,7 @@ .\" documentation and/or other materials provided with the distribution. .\" .\" -.\" $Id: lptcontrol.1,v 1.3 1994/05/22 12:31:54 csgr Exp $ +.\" $Id: lptcontrol.8,v 1.2 1994/09/03 22:46:49 csgr Exp $ .Dd September 3, 1994 .Dt LPTCONTROL 8 .Os FreeBSD 2 @@ -60,12 +60,12 @@ must be specified. .Bl -tag -width indent -compact .It Pa /dev/lpt? - printer devices .It Pa /dev/lpctl? - printer control devices +.It Pa /sys/i386/conf/GENERIC - kernel configuration file .El .Sh BUGS Sure to be some. .Sh "SEE ALSO" .Xr lpt 4 -.Xr /sys/i386/conf/GENERICAH .Sh AUTHOR Geoffrey M. Rehmet .Sh HISTORY diff --git a/usr.sbin/pkg_install/add/pkg_add.1 b/usr.sbin/pkg_install/add/pkg_add.1 index 8e4a0f7..b8f4400 100644 --- a/usr.sbin/pkg_install/add/pkg_add.1 +++ b/usr.sbin/pkg_install/add/pkg_add.1 @@ -343,6 +343,6 @@ and the link names are extracted with a single command (not split between invocations due to exec argument-space limitations--this depends on the value returned by -.Xr sysconf _SC_ARG_MAX ). +.Fn sysconf _SC_ARG_MAX ) . .Pp Sure to be others. diff --git a/usr.sbin/pkg_install/create/pkg_create.1 b/usr.sbin/pkg_install/create/pkg_create.1 index 5ac26dd..112c02b 100644 --- a/usr.sbin/pkg_install/create/pkg_create.1 +++ b/usr.sbin/pkg_install/create/pkg_create.1 @@ -15,7 +15,7 @@ .\" .\" .\" @(#)pkg_create.1 -.\" $Id: pkg_create.1,v 1.14 1995/04/22 00:03:12 jkh Exp $ +.\" $Id: pkg_create.1,v 1.15 1996/02/12 04:56:38 mpp Exp $ .\" .\" hacked up by John Kohl for NetBSD--fixed a few bugs, extended keywords, .\" added dependency tracking, etc. @@ -376,6 +376,6 @@ extracted. They additionally must not end up being split between .Cm tar invocations due to exec argument-space limitations (this depends on the value returned by -.Xr sysconf _SC_ARG_MAX ). +.Fn sysconf _SC_ARG_MAX ) . .Pp Sure to be others. diff --git a/usr.sbin/rpc.yppasswdd/rpc.yppasswdd.8 b/usr.sbin/rpc.yppasswdd/rpc.yppasswdd.8 index 32706fe..c68743a 100644 --- a/usr.sbin/rpc.yppasswdd/rpc.yppasswdd.8 +++ b/usr.sbin/rpc.yppasswdd/rpc.yppasswdd.8 @@ -28,7 +28,7 @@ .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" -.\" $Id: rpc.yppasswdd.8,v 1.5 1996/02/24 21:41:47 wpaul Exp $ +.\" $Id: rpc.yppasswdd.8,v 1.2 1996/02/24 22:10:38 wpaul Exp $ .\" .Dd February 8, 1996 .Dt RPC.YPPASSWDD 8 @@ -105,7 +105,7 @@ script to rebuild the NIS maps. (This script has two arguments passed to it: the absolute pathname of the password template that was modified and the name of the domain that is to be updated. These in turn are passed to -.Pa /var/yp/Makefile.) +.Pa /var/yp/Makefile ) . .Pp The FreeBSD version of .Nm rpc.yppasswdd -- cgit v1.1