summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authoraaron <aaron@openbsd.org>2000-03-07 21:11:07 +0000
committeraaron <aaron@openbsd.org>2000-03-07 21:11:07 +0000
commit453cecf0142cbcb6797621bda4984a3ca4633cd9 (patch)
treedc3577b30b359020329208ac30207e2e89259523
parenttypo: ignore_user_known_hosts int->flag; naddy@mips.rhein-neckar.de (diff)
downloadwireguard-openbsd-453cecf0142cbcb6797621bda4984a3ca4633cd9.tar.xz
wireguard-openbsd-453cecf0142cbcb6797621bda4984a3ca4633cd9.zip
Various cleanup.
-rw-r--r--usr.bin/error/error.122
-rw-r--r--usr.bin/expand/expand.117
-rw-r--r--usr.bin/file2c/file2c.122
-rw-r--r--usr.bin/find/find.18
-rw-r--r--usr.bin/finger/finger.15
-rw-r--r--usr.bin/fmt/fmt.128
-rw-r--r--usr.bin/fsplit/fsplit.128
-rw-r--r--usr.bin/fstat/fstat.188
-rw-r--r--usr.bin/ftp/ftp.1233
-rw-r--r--usr.bin/gencat/gencat.178
-rw-r--r--usr.bin/getconf/getconf.14
-rw-r--r--usr.bin/getopt/getopt.118
-rw-r--r--usr.bin/gprof/gprof.114
-rw-r--r--usr.bin/head/head.13
-rw-r--r--usr.bin/hexdump/hexdump.140
-rw-r--r--usr.bin/hexdump/od.17
-rw-r--r--usr.bin/id/groups.18
-rw-r--r--usr.bin/id/id.121
-rw-r--r--usr.bin/id/whoami.19
19 files changed, 405 insertions, 248 deletions
diff --git a/usr.bin/error/error.1 b/usr.bin/error/error.1
index ebc6c68a6d6..99ae97eb183 100644
--- a/usr.bin/error/error.1
+++ b/usr.bin/error/error.1
@@ -1,4 +1,4 @@
-.\" $OpenBSD: error.1,v 1.8 1999/12/04 19:04:52 aaron Exp $
+.\" $OpenBSD: error.1,v 1.9 2000/03/07 21:11:07 aaron Exp $
.\" $NetBSD: error.1,v 1.3 1995/09/02 06:15:20 jtc Exp $
.\"
.\" Copyright (c) 1980, 1990, 1993
@@ -67,9 +67,7 @@ Do
touch any files; all error messages are sent to the
standard output.
.It Fl q
-The user is
-.Ar queried
-whether s/he wants to touch the file.
+The user is queried whether or not to touch the file.
A
.Sq y
or
@@ -106,15 +104,13 @@ Thus the suffix list:
allows
.Nm
to touch files ending with
-.Sq \&.c ,
-.Sq \&.y ,
-.Sq \&.foo\&* ,
+.Dq \&.c ,
+.Dq \&.y ,
+.Dq \&.foo\&* ,
and
-.Sq \&.h .
+.Dq \&.h .
.It Fl s
-Print out
-.Em statistics
-regarding the error categorization.
+Print out statistics regarding the error categorization.
Not too useful.
.It Fl I Ar ignorefile
Specifies a file containing a list of functions to ignore.
@@ -169,8 +165,8 @@ knows about the error messages produced by:
.Xr pi 1 ,
.Xr pc 1 ,
.Xr f77 1 ,
-and
-.Em DEC Western Research Modula\-2 .
+and DEC Western Research Modula\-2.
+.Pp
.Nm
knows a standard format for error messages produced by
the language processors,
diff --git a/usr.bin/expand/expand.1 b/usr.bin/expand/expand.1
index 2597527e8e2..45d634bc5c6 100644
--- a/usr.bin/expand/expand.1
+++ b/usr.bin/expand/expand.1
@@ -1,4 +1,4 @@
-.\" $OpenBSD: expand.1,v 1.6 1999/07/04 11:53:53 aaron Exp $
+.\" $OpenBSD: expand.1,v 1.7 2000/03/07 21:11:08 aaron Exp $
.\" $NetBSD: expand.1,v 1.3 1995/09/02 06:19:45 jtc Exp $
.\"
.\" Copyright (c) 1980, 1990, 1993
@@ -50,12 +50,12 @@
.Op Fl a
.Op Ar file Ar ...
.Sh DESCRIPTION
-.Nm
+.Nm expand
processes the named files or the standard input writing
the standard output with tabs changed into blanks.
Backspace characters are preserved into the output and decrement
the column count for tab calculations.
-.Nm
+.Nm expand
is useful for pre-processing character files
(before sorting, looking at specific columns, etc.) that
contain tabs.
@@ -72,19 +72,22 @@ specific columns.
puts tabs back into the data from the standard input or the named
files and writes the result on the standard output.
.Pp
-Option (with
+The options (for
.Nm unexpand
-only):
+only) are as follows:
.Bl -tag -width flag
.It Fl a
By default, only leading blanks and tabs
-are reconverted to maximal strings of tabs. If the
+are reconverted to maximal strings of tabs.
+If the
.Fl a
option is given, tabs are inserted whenever they would compress the
resultant file by replacing two or more characters.
.El
+.Sh SEE ALSO
+.Xr fold 1
.Sh HISTORY
The
-.Nm
+.Nm expand
command appeared in
.Bx 3.0 .
diff --git a/usr.bin/file2c/file2c.1 b/usr.bin/file2c/file2c.1
index 18e96e6cb5a..e563265abd9 100644
--- a/usr.bin/file2c/file2c.1
+++ b/usr.bin/file2c/file2c.1
@@ -5,7 +5,7 @@
.\" this stuff is worth it, you can buy me a beer in return. Poul-Henning Kamp
.\" ---------------------------------------------------------------------------
.\"
-.\" $Id: file2c.1,v 1.6 1999/07/04 11:53:54 aaron Exp $
+.\" $Id: file2c.1,v 1.7 2000/03/07 21:11:08 aaron Exp $
.\"
.Dd January 28, 1995
.Dt FILE2C 1
@@ -20,18 +20,21 @@
.Sh DESCRIPTION
The
.Nm
-utility reads a file from stdin and writes it to stdout, converting each
+utility reads a file from the standard input and writes it to the standard
+output, converting each
byte to its decimal representation on the fly.
.Pp
If the first
-.Op string
-is present, it is printed before the data. If the second
-.Op string
+.Ar string
+is present, it is printed before the data.
+If the second
+.Ar string
is present, it is printed after the data.
.Pp
This program is used to embed binary or other files into C source files,
-for instance as a char[].
-.Sh EXAMPLE
+for instance as a
+.Li char[] .
+.Sh EXAMPLES
The command:
.Bd -literal -offset indent
date | file2c 'const char date[] = {' ',0};'
@@ -44,5 +47,6 @@ const char date[] = {
32,80,83,84,32,49,57,57,53,10
,0};
.Ed
-
-
+.Sh SEE ALSO
+.Xr hexdump 1 ,
+.Xr od 1
diff --git a/usr.bin/find/find.1 b/usr.bin/find/find.1
index 3306c4e2089..4b5b9251c2a 100644
--- a/usr.bin/find/find.1
+++ b/usr.bin/find/find.1
@@ -1,4 +1,4 @@
-.\" $OpenBSD: find.1,v 1.25 2000/03/06 03:15:59 aaron Exp $
+.\" $OpenBSD: find.1,v 1.26 2000/03/07 21:11:08 aaron Exp $
.\" Copyright (c) 1990, 1993
.\" The Regents of the University of California. All rights reserved.
.\"
@@ -527,7 +527,7 @@ are extensions to
.Pp
Historically, the
.Fl d ,
-.Fl H
+.Fl H ,
and
.Fl x
options were implemented using the primaries
@@ -600,8 +600,8 @@ construct.
.Pp
The
.Fl W
-option is probably not the most elegant way to handle whiteouts. It may
-be replaced by a more sophisticated algorithm eventually.
+option is probably not the most elegant way to handle whiteouts.
+It may be replaced by a more sophisticated algorithm eventually.
.Sh HISTORY
A
.Nm
diff --git a/usr.bin/finger/finger.1 b/usr.bin/finger/finger.1
index 5203e241377..faafaccfa57 100644
--- a/usr.bin/finger/finger.1
+++ b/usr.bin/finger/finger.1
@@ -1,4 +1,4 @@
-.\" $OpenBSD: finger.1,v 1.12 2000/01/12 01:53:30 aaron Exp $
+.\" $OpenBSD: finger.1,v 1.13 2000/03/07 21:11:08 aaron Exp $
.\"
.\" Copyright (c) 1989, 1990 The Regents of the University of California.
.\" All rights reserved.
@@ -179,7 +179,8 @@ is case insensitive.
.It Fl M
Enable matching of
.Ar user
-names. This is disabled by default on systems running YP or with large
+names.
+This is disabled by default on systems running YP or with large
password databases.
.El
.Pp
diff --git a/usr.bin/fmt/fmt.1 b/usr.bin/fmt/fmt.1
index 5bbedcf58a3..66cc1c5cfb6 100644
--- a/usr.bin/fmt/fmt.1
+++ b/usr.bin/fmt/fmt.1
@@ -1,4 +1,4 @@
-.\" $OpenBSD: fmt.1,v 1.8 2000/03/05 00:28:53 aaron Exp $
+.\" $OpenBSD: fmt.1,v 1.9 2000/03/07 21:11:08 aaron Exp $
.\"
.\" Copyright (c) 1980, 1990, 1993
.\" The Regents of the University of California. All rights reserved.
@@ -51,7 +51,7 @@
.Ar goal
.Op Ar maximum
.Oc
-.Op name ...
+.Op Ar name ...
.Sh DESCRIPTION
.Nm
is a simple text formatter which reads the concatenation of input
@@ -66,19 +66,21 @@ The
length defaults
to 65 and the
.Ar maximum
-to 10 more than the goal length. The spacing at the beginning of the
-input lines is preserved in the output, as are blank lines and
-interword spacing.
+to 10 more than the goal length.
+The spacing at the beginning of the input lines is preserved in the output,
+as are blank lines and interword spacing.
.Pp
The options are as follows:
.Bl -tag -width indent
.It Fl c
-Center the text, line by line. In this case, most of the other
+Center the text, line by line.
+In this case, most of the other
options are ignored; no splitting or joining of lines is done.
.It Fl m
Try to format mail header lines contained in the input sensibly.
.It Fl p
-Allow indented paragraphs. Without the
+Allow indented paragraphs.
+Without the
.Fl p
flag, any change in the amount of whitespace at the start of a line
results in a new paragraph being begun.
@@ -89,9 +91,11 @@ sentence, a double space.)
.It Fl d Ar chars
Treat the
.Ar chars
-(and no others) as sentence-ending characters. By default the
+(and no others) as sentence-ending characters.
+By default the
sentence-ending characters are full stop, question mark and
-exclamation mark. Remember that some characters may need to be
+exclamation mark.
+Remember that some characters may need to be
escaped to protect them from your shell.
.It Fl l Ar number
Replace multiple spaces with tabs at the start of each output
@@ -101,7 +105,8 @@ spaces will be replaced with one tab.
.It Fl t Ar number
Assume that the input files' tabs assume
.Ar number
-spaces per tab stop. The default is 8.
+spaces per tab stop.
+The default is 8.
.El
.Pp
.Nm
@@ -128,8 +133,7 @@ command appeared in
.Bx 3 .
.Pp
The version described herein is a complete rewrite and appeared in
-.Bx Open
-2.4.
+.Ox 2.4 .
.\" .Sh AUTHOR
.\" Kurt Shoens
.\" .br
diff --git a/usr.bin/fsplit/fsplit.1 b/usr.bin/fsplit/fsplit.1
index 8d881780ae0..72f8830754c 100644
--- a/usr.bin/fsplit/fsplit.1
+++ b/usr.bin/fsplit/fsplit.1
@@ -1,4 +1,4 @@
-.\" $OpenBSD: fsplit.1,v 1.6 1999/07/04 11:53:54 aaron Exp $
+.\" $OpenBSD: fsplit.1,v 1.7 2000/03/07 21:11:08 aaron Exp $
.\" $NetBSD: fsplit.1,v 1.3 1995/09/28 05:15:06 perry Exp $
.\"
.\" Copyright (c) 1983, 1990, 1993
@@ -54,9 +54,11 @@ form
.Ar name.f ,
where
.Ar name
-is the name of the program unit (e.g. function, subroutine, block data or
-program). The name for unnamed block data subprograms has the form
-.Ar blkdtaNNN.f
+is the name of the program unit (e.g., function, subroutine, block data or
+program).
+.Pp
+The name for unnamed block data subprograms has the form
+.Ar blkdtaNNN.f ,
where NNN is three digits and a file of this name does not already exist.
For unnamed main programs the name has the form
.Ar mainNNN.f .
@@ -64,20 +66,27 @@ If there is an error in classifying a program unit, or if
.Ar name.f
already exists,
the program unit will be put in a file of the form
-.Ar zzzNNN.f
+.Ar zzzNNN.f ,
where
.Ar zzzNNN.f
does not already exist.
+.Pp
+The options are as follows:
.Bl -tag -width Fl
.It Fl e Ar efile
-Normally each subprogram unit is split into a separate file. When the
+Normally each subprogram unit is split into a separate file.
+When the
.Fl e
option is used, only the specified subprogram units are split into separate
-files. E.g.:
+files. e.g.,
.Pp
.Dl fsplit -e readit -e doit prog.f
.Pp
-will split readit and doit into separate files.
+will split
+.Dq readit
+and
+.Dq doit
+into separate files.
.El
.Sh DIAGNOSTICS
If names specified via the
@@ -95,7 +104,8 @@ Asa Romberger and Jerry Berkman
.Sh BUGS
.Nm
assumes the subprogram name is on the first noncomment line of the subprogram
-unit. Nonstandard source formats may confuse
+unit.
+Non-standard source formats may confuse
.Nm fsplit .
.Pp
It is hard to use
diff --git a/usr.bin/fstat/fstat.1 b/usr.bin/fstat/fstat.1
index 3ff418d574a..fa0365256e0 100644
--- a/usr.bin/fstat/fstat.1
+++ b/usr.bin/fstat/fstat.1
@@ -1,4 +1,5 @@
-.\" $OpenBSD: fstat.1,v 1.15 2000/01/19 07:38:25 pjanzen Exp $
+.\" $OpenBSD: fstat.1,v 1.16 2000/03/07 21:11:09 aaron Exp $
+.\"
.\" Copyright (c) 1987, 1991, 1993
.\" The Regents of the University of California. All rights reserved.
.\"
@@ -45,7 +46,7 @@
.Op Fl N Ar system
.Op Fl p Ar pid
.Op Fl u Ar user
-.Op Ar filename...
+.Op Ar file ...
.Sh DESCRIPTION
.Nm fstat
identifies open files.
@@ -59,14 +60,14 @@ reports on all open files in the system.
The options are as follows:
.Bl -tag -width Ds
.It Fl f
-Restrict examination to files open in the same filesystems as
-the named file arguments, or to the filesystem containing the
+Restrict examination to files open in the same file systems as
+the named file arguments, or to the file system containing the
current directory if there are no additional filename arguments.
-For example, to find all files open in the filesystem where the
+For example, to find all files open in the file system where the
directory
.Pa /usr/src
resides, type
-.Dq Li fstat -f /usr/src .
+.Ic fstat -f /usr/src .
.It Fl M Ar core
Extract values associated with the name list from the specified core
instead of the default
@@ -75,28 +76,30 @@ instead of the default
Extract the name list from the specified system instead of the default
.Pa /bsd .
.It Fl n
-Numerical format. Print the device number (maj,min) of the filesystem
-the file resides in rather than the mount point name; for special
+Numerical format.
+Print the device number (maj,min) of the file system
+the file resides in rather than the mount point name. For special
files, print the
device number that the special device refers to rather than the filename
in
-.Pa /dev ;
-and print the mode of the file in octal instead of symbolic form.
+.Pa /dev .
+Also, print the mode of the file in octal instead of symbolic form.
.It Fl p pid
Report all files open by the specified process.
.It Fl u user
Report all files open by the specified user.
.It Fl v
-Verbose mode. Print error messages upon failures to locate particular
-system data structures rather than silently ignoring them. Most of
-these data structures are dynamically created or deleted and it is
+Verbose mode.
+Print error messages upon failures to locate particular
+system data structures rather than silently ignoring them.
+Most of these data structures are dynamically created or deleted and it is
possible for them to disappear while
.Nm fstat
-is running. This
-is normal and unavoidable since the rest of the system is running while
+is running.
+This is normal and unavoidable since the rest of the system is running while
.Nm fstat
itself is running.
-.It Ar filename ...
+.It Ar file ...
Restrict reports to the specified files.
.El
.Pp
@@ -119,8 +122,9 @@ root - root inode
tr - kernel trace file
.Ed
.Pp
-If the file number is followed by an asterisk (``*''), the file is
-not an inode, but rather a socket,
+If the file number is followed by an asterisk
+.Pq Ql * ,
+the file is not an inode, but rather a socket,
.Tn FIFO ,
or there is an error.
In this case the remainder of the line doesn't
@@ -131,7 +135,7 @@ is described later under
If the
.Fl n
flag wasn't specified, this header is present and is the
-pathname that the filesystem the file resides in is mounted on.
+pathname that the file system the file resides in is mounted on.
.It Li DEV
If the
.Fl n
@@ -149,22 +153,26 @@ otherwise, the mode is printed
as an octal number.
.It Li SZ\&|DV
If the file is not a character or block special file, prints the size of
-the file in bytes. Otherwise, if the
+the file in bytes.
+Otherwise, if the
.Fl n
flag is not specified, prints
the name of the special file as located in
.Pa /dev .
-If that cannot be
-located, or the
+If that cannot be located, or the
.Fl n
flag is specified, prints the major/minor device
number that the special device refers to.
.It Li R/W
This column describes the access mode that the file allows.
-The letter ``r'' indicates open for reading;
-the letter ``w'' indicates open for writing.
+The letter
+.Sq r
+indicates open for reading;
+the letter
+.Sq w
+indicates open for writing.
This field is useful when trying to find the processes that are
-preventing a filesystem from being downgraded to read-only.
+preventing a file system from being downgraded to read-only.
.It Li NAME
If filename arguments are specified and the
.Fl f
@@ -172,7 +180,8 @@ flag is not, then
this field is present and is the name associated with the given file.
Normally the name cannot be determined since there is no mapping
from an open file back to the directory entry that was used to open
-that file. Also, since different directory entries may reference
+that file.
+Also, since different directory entries may reference
the same file (via
.Xr ln 2 ) ,
the name printed may not be the actual
@@ -193,13 +202,17 @@ permit further analysis without duplicating
.Xr netstat 1 .
.Pp
For example, the addresses mentioned above are the addresses which the
-.Dq Li netstat -A
+.Ic netstat -A
command would print for TCP, UDP, and Unix domain.
Note that since pipes are implemented using sockets, a pipe appears as a
connected Unix domain stream socket.
A unidirectional Unix domain socket indicates the direction of flow with
-an arrow (``<-'' or ``->''), and a full duplex socket shows a double arrow
-(``<->'').
+an arrow
+.Pf ( Dq <-
+or
+.Dq -> ) ,
+and a full duplex socket shows a double arrow
+.Pq Dq <-> ) .
.Pp
For AF_INET sockets,
.Nm fstat
@@ -207,12 +220,21 @@ also attempts to print the internet address and port for the
local end of a connection.
If the socket is connected, it also prints the remote internet address
and port.
-A ``*'' is used to indicate an INADDR_ANY binding. In this case, the
-use of the arrow (``<--'' or ``-->'') indicates the direction the socket
-connection was created.
+A
+.Ql *
+is used to indicate an
+.Dv INADDR_ANY
+binding.
+In this case, the
+use of the arrow
+.Pf ( Dq <--
+or
+.Dq --> )
+indicates the direction the socket connection was created.
.Sh PIPES
Every pipe is printed as an address which is the same for both sides of
-the pipe and a state that is built of the letters 'RWE'.
+the pipe and a state that is built of the letters
+.Dq RWE .
W - The pipe blocks waiting for the reader to read data.
R - The pipe blocks waiting for the writer to write data.
E - The pipe is in EOF state.
diff --git a/usr.bin/ftp/ftp.1 b/usr.bin/ftp/ftp.1
index 377b05851b4..d35d3e5eb78 100644
--- a/usr.bin/ftp/ftp.1
+++ b/usr.bin/ftp/ftp.1
@@ -1,4 +1,4 @@
-.\" $OpenBSD: ftp.1,v 1.28 2000/02/29 04:52:37 aaron Exp $
+.\" $OpenBSD: ftp.1,v 1.29 2000/03/07 21:11:09 aaron Exp $
.\" $NetBSD: ftp.1,v 1.22 1997/08/18 10:20:22 lukem Exp $
.\"
.\" Copyright (c) 1985, 1989, 1990, 1993
@@ -65,19 +65,23 @@ remote network site.
.Pp
The latter three usage formats will fetch a file using either the
HTTP or FTP protocols into the current directory.
-This is ideal for scripts. Refer to
+This is ideal for scripts.
+Refer to
.Sx AUTO-FETCHING FILES
below for more information.
.Pp
The options are as follows:
.Bl -tag -width "port "
.It Fl A
-Force active mode ftp. By default,
+Force active mode ftp.
+By default,
.Nm
will try to use passive mode ftp and fall back to active mode
-if passive is not supported by the server. This option causes
+if passive is not supported by the server.
+This option causes
.Nm
-to always use an active connection. It is only useful for connecting
+to always use an active connection.
+It is only useful for connecting
to very old servers that do not implement passive mode properly.
.It Fl a
Causes
@@ -86,7 +90,8 @@ to bypass the normal login procedure and use an anonymous login instead.
.It Fl d
Enables debugging.
.It Fl e
-Disables command line editing. Useful for Emacs ange-ftp.
+Disables command line editing.
+Useful for Emacs ange-ftp.
.It Fl g
Disables file name globbing.
.It Fl i
@@ -163,7 +168,7 @@ from the user.
When
.Nm
is awaiting commands the prompt
-.Ql ftp>
+.Dq ftp>
is provided to the user.
The following commands are recognized
by
@@ -196,9 +201,9 @@ or
.Ic nmap
setting.
File transfer uses the current settings for
-.Ic type ,
+.Ic type ,
.Ic format ,
-.Ic mode ,
+.Ic mode ,
and
.Ic structure .
.It Ic ascii
@@ -281,7 +286,7 @@ When debugging is on,
.Nm
prints each command sent to the remote machine,
preceded by the string
-.Ql \-\->
+.Ql \-\-> .
.It Ic dir Op Ar remote-directory Op Ar local-file
Print a listing of the contents of a
directory on the remote machine.
@@ -305,7 +310,7 @@ output.
If no local file is specified, or if
.Ar local-file
is
-.Sq Fl ,
+.Dq - ,
the output is sent to the terminal.
.It Ic disconnect
A synonym for
@@ -335,15 +340,15 @@ If the local
file name is not specified, it is given the same
name it has on the remote machine, subject to
alteration by the current
-.Ic case ,
+.Ic case ,
.Ic ntrans ,
and
.Ic nmap
settings.
The current settings for
-.Ic type ,
+.Ic type ,
.Ic form ,
-.Ic mode ,
+.Ic mode ,
and
.Ic structure
are used while transferring the file.
@@ -364,12 +369,12 @@ is also given, that will be used as the port to connect to on the
gate-ftp server.
.It Ic glob
Toggle filename expansion for
-.Ic mdelete ,
+.Ic mdelete ,
.Ic mget
and
.Ic mput .
If globbing is turned off with
-.Ic glob ,
+.Ic glob ,
the file name arguments
are taken literally and not expanded.
Globbing for
@@ -379,7 +384,7 @@ is done as in
For
.Ic mdelete
and
-.Ic mget ,
+.Ic mget ,
each remote file name is expanded
separately on the remote machine and the lists are not merged.
Expansion of a directory name is likely to be
@@ -398,8 +403,9 @@ transferring a
.Xr tar 1
archive of the subtree (in binary mode).
.It Ic hash Op Ar size
-Toggle hash-sign (``#'') printing for each data block
-transferred.
+Toggle hash mark
+.Pq Ql #
+printing for each data block transferred.
The size of a data block defaults to 1024 bytes.
This can be changed by specifying
.Ar size
@@ -443,12 +449,12 @@ output.
If no local file is specified, or if
.Ar local-file
is
-.Fl ,
+.Dq - ,
the output is sent to the terminal.
.It Ic macdef Ar macro-name
Define a macro.
Subsequent lines are stored as the macro
-.Ar macro-name ;
+.Ar macro-name ;
a null line (consecutive newline characters
in a file or
carriage returns from the terminal) terminates macro input mode.
@@ -457,23 +463,40 @@ defined macros.
Macros remain defined until a
.Ic close
command is executed.
-The macro processor interprets `$' and `\e' as special characters.
-A `$' followed by a number (or numbers) is replaced by the
+The macro processor interprets
+.Ql $
+and
+.Ql \e
+as special characters.
+A
+.Ql $
+followed by a number (or numbers) is replaced by the
corresponding argument on the macro invocation command line.
-A `$' followed by an `i' tells the macro processor that the
+A
+.Ql $
+followed by an
+.Sq i
+tells the macro processor that the
executing macro is to be looped.
-On the first pass `$i' is
+On the first pass
+.Ql $i
+is
replaced by the first argument on the macro invocation command line,
on the second pass it is replaced by the second argument, and so on.
-A `\e' followed by any character is replaced by that character.
-Use the `\e' to prevent special treatment of the `$'.
+A
+.Ql \e
+followed by any character is replaced by that character.
+Use the
+.Ql \e
+to prevent special treatment of the
+.Ql $ .
.It Ic mdelete Op Ar remote-files
Delete the
.Ar remote-files
on the remote machine.
.It Ic mdir Ar remote-files local-file
Like
-.Ic dir ,
+.Ic dir ,
except multiple remote files may be specified.
If interactive prompting is on,
.Nm
@@ -492,7 +515,7 @@ See
.Ic glob
for details on the filename expansion.
Resulting file names will then be processed according to
-.Ic case ,
+.Ic case ,
.Ic ntrans ,
and
.Ic nmap
@@ -506,7 +529,7 @@ new local directories can be created with
Make a directory on the remote machine.
.It Ic mls Ar remote-files local-file
Like
-.Ic ls ,
+.Ic ls ,
except multiple remote files may be specified,
and the
.Ar local-file
@@ -584,9 +607,18 @@ and
.Ic case
settings).
Variable templating is accomplished by including the
-sequences `$1', `$2', ..., `$9' in
+sequences
+.Ql $1 ,
+.Ql $2 ,
+...,
+.Ql $9
+in
.Ar inpattern .
-Use `\\' to prevent this special treatment of the `$' character.
+Use
+.Ql \e
+to prevent this special treatment of the
+.Ql $
+character.
All other characters are treated literally, and are used to determine the
.Ic nmap
.Ar inpattern
@@ -598,11 +630,17 @@ $1.$2 and the remote file name "mydata.data", $1 would have the value
The
.Ar outpattern
determines the resulting mapped filename.
-The sequences `$1', `$2', ...., `$9' are replaced by any value resulting
-from the
+The sequences
+.Ql $1 ,
+.Ql $2 ,
+...,
+.Ql $9
+are replaced by any value resulting from the
.Ar inpattern
template.
-The sequence `$0' is replaced by the original filename.
+The sequence
+.Ql $0
+is replaced by the original filename.
Additionally, the sequence
.Ql Op Ar seq1 , Ar seq2
is replaced by
@@ -618,14 +656,37 @@ nmap $1.$2.$3 [$1,$2].[$2,file]
.Ed
.Pp
would yield
-the output filename "myfile.data" for input filenames "myfile.data" and
-"myfile.data.old", "myfile.file" for the input filename "myfile", and
-"myfile.myfile" for the input filename ".myfile".
+the output filename
+.Pa myfile.data ,
+for input filenames
+.Pa myfile.data
+and
+.Pa myfile.data.old ,
+.Pa myfile.file
+for the input filename
+.Pa myfile ,
+and
+.Pa myfile.myfile
+for the input filename
+.Pa \&.myfile .
Spaces may be included in
-.Ar outpattern ,
-as in the example: `nmap $1 sed "s/ *$//" > $1' .
-Use the `\e' character to prevent special treatment
-of the `$','[','[', and `,' characters.
+.Ar outpattern ,
+as in the example
+.Pp
+.Bd -literal -offset indent -compact
+nmap $1 sed "s/ *$//" > $1 .
+.Ed
+.Pp
+Use the
+.Ql \e
+character to prevent special treatment
+of the
+.Ql $ ,
+.Ql [ ,
+.Ql \&] ,
+and
+.Ql \&,
+characters.
.It Ic ntrans Op Ar inchars Op Ar outchars
Set or unset the filename character translation mechanism.
If no arguments are specified, the filename character
@@ -653,7 +714,7 @@ are replaced with the corresponding character in
If the character's position in
.Ar inchars
is longer than the length of
-.Ar outchars ,
+.Ar outchars ,
the character is deleted from the file name.
.It Ic open Ar host Op Ar port
Establish a connection to the specified
@@ -685,20 +746,23 @@ if
.Ev PAGER
is null or not defined).
.It Ic passive
-Toggle passive mode. If passive mode is turned on
-(default is on), the ftp client will
+Toggle passive mode.
+If passive mode is turned on (default is on), the ftp client will
send a
.Dv PASV
command for all data connections instead of the usual
.Dv PORT
-command. The
+command.
+The
.Dv PASV
command requests that the remote server open a port for the data connection
-and return the address of that port. The remote server listens on that
-port and the client connects to it. When using the more traditional
+and return the address of that port.
+The remote server listens on that port and the client connects to it.
+When using the more traditional
.Dv PORT
command, the client listens on a port and sends that address to the remote
-server, who connects back to it. Passive mode is useful when using
+server, who connects back to it.
+Passive mode is useful when using
.Nm
through a gateway router or host that controls the directionality of
traffic.
@@ -712,7 +776,7 @@ Toggle display of transfer progress bar.
The progress bar will be disabled for a transfer that has
.Ar local-file
as
-.Sq Fl
+.Dq -
or a command that starts with
.Sq \&| .
Refer to
@@ -760,12 +824,14 @@ servers for transferring files between the two servers.
The first
.Ic proxy
command should be an
-.Ic open ,
+.Ic open ,
to establish the secondary control connection.
-Enter the command "proxy ?" to see other ftp commands executable on the
+Enter the command
+.Ic proxy ?
+to see other ftp commands executable on the
secondary connection.
The following commands behave differently when prefaced by
-.Ic proxy :
+.Ic proxy :
.Ic open
will not define new macros during the auto-login process,
.Ic close
@@ -775,7 +841,7 @@ and
.Ic mget
transfer files from the host on the primary control connection
to the host on the secondary control connection, and
-.Ic put ,
+.Ic put ,
.Ic mput ,
and
.Ic append
@@ -797,9 +863,9 @@ settings
in naming the remote file.
File transfer uses the
current settings for
-.Ic type ,
+.Ic type ,
.Ic format ,
-.Ic mode ,
+.Ic mode ,
and
.Ic structure .
.It Ic pwd
@@ -820,7 +886,7 @@ Reget acts like get, except that if
.Ar local-file
exists and is
smaller than
-.Ar remote-file ,
+.Ar remote-file ,
.Ar local-file
is presumed to be
a partially transferred copy of
@@ -878,10 +944,16 @@ local filename for a
.Ic get
or
.Ic mget
-command, a ".1" is appended to the name.
+command, a
+.Dq \&.1
+is appended to the name.
If the resulting name matches another existing file,
-a ".2" is appended to the original name.
-If this process continues up to ".99", an error
+a
+.Dq \&.2
+is appended to the original name.
+If this process continues up to
+.Dq \&.99 ,
+an error
message is printed, and the transfer does not take place.
The generated unique filename will be reported.
Note that
@@ -1021,7 +1093,9 @@ A synonym for
.El
.Pp
Command arguments which have embedded spaces may be quoted with
-quote `"' marks.
+quote
+.Pq Ql "
+marks.
.Pp
Commands which toggle settings can take an explicit
.Ic on
@@ -1142,10 +1216,10 @@ commands are processed according to the following rules.
.Bl -enum
.It
If the file name
-.Sq Fl
-is specified, the stdin
-(for reading) or stdout
-(for writing) is used.
+.Dq -
+is specified, the standard input (for reading)
+or standard output (for writing)
+is used.
.It
If the first character of the file name is
.Sq \&| ,
@@ -1154,26 +1228,30 @@ remainder of the argument is interpreted as a shell command.
.Nm
then forks a shell, using
.Xr popen 3
-with the argument supplied, and reads (writes) from the stdout
-(stdin).
+with the argument supplied, and reads (writes) from the standard output
+(standard input).
If the shell command includes spaces, the argument
-must be quoted; e.g.
+must be quoted; e.g.,
\*(Lq" ls -lt"\*(Rq.
A particularly
useful example of this mechanism is: \*(Lqdir \&|more\*(Rq.
.It
-Failing the above checks, if ``globbing'' is enabled,
+Failing the above checks, if
+.Dq globbing
+is enabled,
local file names are expanded
according to the rules used in the
-.Xr csh 1 ;
+.Xr csh 1 ;
c.f. the
.Ic glob
command.
If the
.Nm
-command expects a single local file (.e.g.
-.Ic put ) ,
-only the first filename generated by the "globbing" operation is used.
+command expects a single local file (e.g.,
+.Ic put ) ,
+only the first filename generated by the
+.Dq globbing
+operation is used.
.It
For
.Ic mget
@@ -1181,7 +1259,7 @@ commands and
.Ic get
commands with unspecified local file names, the local filename is
the remote filename, which may be altered by a
-.Ic case ,
+.Ic case ,
.Ic ntrans ,
or
.Ic nmap
@@ -1224,7 +1302,7 @@ mode transfers.
.Nm
supports only the default values for the remaining
file transfer parameters:
-.Ic mode ,
+.Ic mode ,
.Ic form ,
and
.Ic struct .
@@ -1296,7 +1374,7 @@ Note that if this token is present in the
.Pa .netrc
file for any user other
than
-.Ar anonymous ,
+.Ar anonymous ,
.Nm
will abort the auto-login process if the
.Pa .netrc
@@ -1358,7 +1436,8 @@ By default, this is bound to the TAB key.
utilizes the following environment variables:
.Bl -tag -width "FTPSERVERPORT"
.It Ev FTPMODE
-Overrides the default operation mode. Recognized values are:
+Overrides the default operation mode.
+Recognized values are:
.Bl -tag -width "passive "
.It passive
passive mode ftp only
diff --git a/usr.bin/gencat/gencat.1 b/usr.bin/gencat/gencat.1
index 22bc401d4e5..d961cc3c9e7 100644
--- a/usr.bin/gencat/gencat.1
+++ b/usr.bin/gencat/gencat.1
@@ -1,4 +1,4 @@
-.\" $OpenBSD: gencat.1,v 1.8 1999/06/05 01:21:26 aaron Exp $
+.\" $OpenBSD: gencat.1,v 1.9 2000/03/07 21:11:09 aaron Exp $
.\"
.\" Copyright (c) 1997 Ken Stailey
.\"
@@ -24,7 +24,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: gencat.1,v 1.8 1999/06/05 01:21:26 aaron Exp $
+.\" $Id: gencat.1,v 1.9 2000/03/07 21:11:09 aaron Exp $
.\"
.Dd June 11, 1997
.Dt GENCAT 1
@@ -35,7 +35,7 @@
.Sh SYNOPSIS
.Nm gencat
.Ar output-file
-.Ar input-file Op Ar input-file...
+.Ar input-file Op Ar ...
.Sh DESCRIPTION
The
.Nm
@@ -45,7 +45,8 @@ into a formatted message catalog file
.Ar output-file .
The file
.Ar output-file
-will be created if it does not already exist. If
+will be created if it does not already exist.
+If
.Ar output-file
does exist, its messages will be included in the new
.Ar output-file .
@@ -54,31 +55,39 @@ If set and message numbers collide, the new message text defined in
will replace the old message text currently contained in
.Ar output-file .
.Sh INPUT FILES
-The format of a message text source file is defined below. Note that
-the fields of a message text source line are separated by a single space
-character: any other space characters are considered to be part of the
-field contents.
+The format of a message text source file is defined below.
+Note that the fields of a message text source line are separated by a
+single space character; any other space characters are considered to be
+part of the field contents.
.Pp
.Bl -tag -width
.It Li $set Ar n comment
This line specifies the set identifier of the following messages until
the next
.Li $set
-or end-of-file appears. The argument
+or end-of-file appears.
+The argument
.Ar n
is the set identifier which is defined as a number in the range
-[1, (NL_SETMAX)]. Set identifiers must occur in ascending order within
-a single source file, but need not be contiguous. Any string following
-a space following the set identifier is treated as a comment. If no
+.Bo 1 ,
+.Dv NL_SETMAX Bc .
+Set identifiers must occur in ascending order within
+a single source file, but need not be contiguous.
+Any string following
+a space following the set identifier is treated as a comment.
+If no
.Li $set
-directive is specified in a given source file, all messages will
-be located in the default message set NL_SETD.
+directive is specified in a given source file, all messages will
+be located in the default message set
+.Dv NL_SETD .
.It Li $del Ar n comment
This line deletes messages from set
.Ar n
-from a message catalog. The
+from a message catalog.
+The
.Ar n
-specifies a set number. Any string following a space following the set
+specifies a set number.
+Any string following a space following the set
number is treated as a comment.
.It Li $ Ar comment
A line beginning with
@@ -87,7 +96,10 @@ followed by a space is treated as a comment.
.It Ar m message-text
A message line consists of a message identifier
.Ar m
-in the range [1, (NL_MSGMAX)]. The
+in the range
+.Bo 1 ,
+.Dv NL_MSGMAX Bc .
+The
.Ar message-text
is stored in the message catalog with the set identifier specified by
the last
@@ -97,37 +109,43 @@ directive, and the message identifier
If the
.Ar message-text
is empty, and there is a space character following the message identifier,
-an empty string is stored in the message catalog. If the
+an empty string is stored in the message catalog.
+If the
.Ar message-text
is empty, and if there is no space character following the message
identifier, then the existing message in the current set with the
-specified message identifier is deleted from the catalog. Message
-identifiers must be in ascending order within a single set, but
-need not be contiguous. The
+specified message identifier is deleted from the catalog.
+Message identifiers must be in ascending order within a single set, but
+need not be contiguous.
+The
.Ar message-text
-length must be in the range [0, (NL_TEXTMAX)].
+length must be in the range
+.Bo 0 ,
+.Dv NL_TEXTMAX Bc .
.It Li $quote Ar c
This line specifies an optional quote character
.Ar c
which can be used to surround
.Ar message-text
so that trailing space or empty messages are visible in message
-source files. By default, or if an empty
+source files.
+By default, or if an empty
.Li $quote
directive is specified, no quoting of
.Ar message-text
will be recognized.
.El
.Pp
-Empty lines in message source files are ignored. The effect of lines
-beginning with any character other than those described above is
-undefined.
+Empty lines in message source files are ignored.
+The effect of lines beginning with any character other than those
+described above is undefined.
.Pp
Text strings can contain the following special characters and escape
-sequences. In addition, if a quote character is defined, it may be
+sequences.
+In addition, if a quote character is defined, it may be
escaped as well to embed a literal quote character.
.Pp
-.Bl -tag -width Ds -offset indent
+.Bl -tag -width Ds -offset indent -compact
.It Li \en
line feed
.It Li \et
@@ -147,7 +165,7 @@ octal number in the range [000, 377]
.El
.Pp
A backslash character immediately before the end of the line in a file
-is used to continue the line onto the next line, e.g.:
+is used to continue the line onto the next line, e.g.,
.Pp
.Dl 1 This line is continued \e
.Dl on this line.
@@ -157,7 +175,7 @@ the backslash is ignored.
.Pp
The
.Nm
-utility exits 0 on success, or >0 if an error occurs.
+utility exits 0 on success or >0 if an error occurred.
.Sh SEE ALSO
.Xr catclose 3 ,
.Xr catgets 3 ,
diff --git a/usr.bin/getconf/getconf.1 b/usr.bin/getconf/getconf.1
index b3073e4954b..39a500ae7b3 100644
--- a/usr.bin/getconf/getconf.1
+++ b/usr.bin/getconf/getconf.1
@@ -1,4 +1,4 @@
-.\" $OpenBSD: getconf.1,v 1.5 1999/06/05 01:21:26 aaron Exp $
+.\" $OpenBSD: getconf.1,v 1.6 2000/03/07 21:11:09 aaron Exp $
.\" $NetBSD: getconf.1,v 1.2 1996/04/20 01:15:12 jtc Exp $
.\"
.\" Copyright (c) 1996 The NetBSD Foundation, Inc.
@@ -56,7 +56,7 @@ The
.Ar pathname
argument must be supplied for system variables associated with a
pathname.
-.Sh RETURN VALUE
+.Pp
The
.Nm
utility exits 0 on success or >0 if an error occurred.
diff --git a/usr.bin/getopt/getopt.1 b/usr.bin/getopt/getopt.1
index 374ceb174d1..ca3f9c373f2 100644
--- a/usr.bin/getopt/getopt.1
+++ b/usr.bin/getopt/getopt.1
@@ -1,4 +1,4 @@
-.\" $OpenBSD: getopt.1,v 1.5 2000/03/04 22:19:23 aaron Exp $ -*- nroff -*-
+.\" $OpenBSD: getopt.1,v 1.6 2000/03/07 21:11:09 aaron Exp $ -*- nroff -*-
.Dd June 21, 1993
.Dt GETOPT 1
.Os
@@ -32,14 +32,14 @@ preceded by a
.Dq \-
and in its own shell argument;
each option argument is also in its own shell argument.
-.Sh EXAMPLE
+.Sh EXAMPLES
The following code fragment shows how one might process the arguments
for a command that can take the options
-.Op a
+.Fl a
and
-.Op b ,
+.Fl b ,
and the option
-.Op o ,
+.Fl o ,
which requires an argument.
.Pp
.Bd -literal -offset indent
@@ -71,14 +71,14 @@ cmd \-a \-o arg file file
cmd \-oarg -a file file
cmd \-a \-oarg \-\- file file
.Ed
-.Sh SEE ALSO
-.Xr sh 1 ,
-.Xr getopt 3
.Sh DIAGNOSTICS
.Nm
prints an error message on the standard error output when it
encounters an option letter not included in
.Op optstring .
+.Sh SEE ALSO
+.Xr sh 1 ,
+.Xr getopt 3
.Sh HISTORY
Written by Henry Spencer, working from a Bell Labs manual page.
Behavior believed identical to the Bell version.
@@ -88,7 +88,7 @@ Whatever
has.
.Pp
Arguments containing whitespace or embedded shell metacharacters
-generally will not survive intact; this looks easy to fix but isn't.
+generally will not survive intact; this looks easy to fix but isn't.
.Pp
The error message for an invalid option is identified as coming
from
diff --git a/usr.bin/gprof/gprof.1 b/usr.bin/gprof/gprof.1
index 36286529846..e5b4fa8b188 100644
--- a/usr.bin/gprof/gprof.1
+++ b/usr.bin/gprof/gprof.1
@@ -1,4 +1,4 @@
-.\" $OpenBSD: gprof.1,v 1.13 2000/03/05 00:28:53 aaron Exp $
+.\" $OpenBSD: gprof.1,v 1.14 2000/03/07 21:11:09 aaron Exp $
.\" $NetBSD: gprof.1,v 1.6 1995/11/21 22:24:55 jtc Exp $
.\"
.\" Copyright (c) 1983, 1990, 1993
@@ -64,7 +64,7 @@ option also links in versions of the library routines
that are compiled for profiling.
.Nm
reads the given object file (the default is
-.Pa a.out)
+.Pa a.out )
and establishes the relation between its symbol table
and the call graph profile from
.Pa gmon.out .
@@ -92,7 +92,7 @@ time and call counts of the cycle.
.Pp
Second, a flat profile is given,
similar to that provided by
-.Xr prof 1 .
+.Xr prof 1 .
This listing gives the total execution times, the call counts,
the time in milliseconds the call spent in the routine itself, and
the time in milliseconds the call spent in the routine itself including
@@ -141,7 +141,7 @@ option.
Suppresses the printing of the graph profile entry for routine
.Ar name
(and its descendants) as
-.Fl e ,
+.Fl e ,
above, and also excludes the time spent in
.Ar name
(and its descendants) from the total and percentage time computations.
@@ -218,11 +218,11 @@ This is useful with the
option for discovering which routines were never called.
.El
.Sh ENVIRONMENT
+The following environment variables affect the execution of
+.Nm gprof :
.Bl -tag -width PROFDIR
.It Ev PROFDIR
-If the environment variable
-.Ev PROFDIR
-is set, profiling information is placed in that directory in a file named
+Directory to place profiling information in a file named
.Pa pid.progname .
If it is set to a null value, no profiling information is output.
Otherwise, profiling information is placed in the file
diff --git a/usr.bin/head/head.1 b/usr.bin/head/head.1
index f6de89d1e7d..238b12c855b 100644
--- a/usr.bin/head/head.1
+++ b/usr.bin/head/head.1
@@ -1,4 +1,5 @@
-.\" $OpenBSD: head.1,v 1.6 1999/10/17 20:35:45 aaron Exp $
+.\" $OpenBSD: head.1,v 1.7 2000/03/07 21:11:10 aaron Exp $
+.\"
.\" Copyright (c) 1980, 1990 The Regents of the University of California.
.\" All rights reserved.
.\"
diff --git a/usr.bin/hexdump/hexdump.1 b/usr.bin/hexdump/hexdump.1
index 4fbd9db39cf..4cbe7a96b50 100644
--- a/usr.bin/hexdump/hexdump.1
+++ b/usr.bin/hexdump/hexdump.1
@@ -1,4 +1,4 @@
-.\" $OpenBSD: hexdump.1,v 1.9 1999/07/21 12:43:26 aaron Exp $
+.\" $OpenBSD: hexdump.1,v 1.10 2000/03/07 21:11:10 aaron Exp $
.\" Copyright (c) 1989, 1990 The Regents of the University of California.
.\" All rights reserved.
.\"
@@ -77,7 +77,7 @@ Specify a format string to be used for displaying data.
.It Fl f Ar format_file
Specify a file that contains one or more newline separated format strings.
Empty lines and lines whose first non-blank character is a hash mark
-.Pq Dq \&#
+.Pq Ql #
are ignored.
.It Fl n Ar length
Interpret only
@@ -127,7 +127,8 @@ Without the
option, any number of groups of output lines, which would be
identical to the immediately preceding group of output lines (except
for the input offsets), are replaced with a line comprised of a
-single asterisk.
+single asterisk
+.Pq Ql * .
.It Fl x
.Em Two-byte hexadecimal display .
Display the input offset in hexadecimal, followed by eight, space
@@ -158,12 +159,14 @@ If specified it defines the number of bytes to be interpreted by
each iteration of the format.
.Pp
If an iteration count and/or a byte count is specified, a single slash
+.Pq Sq /
must be placed after the iteration count and/or before the byte count
to disambiguate them.
Any whitespace before or after the slash is ignored.
.Pp
The format is required and must be surrounded by double quote
-(" ") marks.
+.Pq \&"\& \&"
+marks.
It is interpreted as an fprintf-style format string (see
.Xr fprintf 3 ) ,
with the
@@ -174,13 +177,18 @@ An asterisk (*) may not be used as a field width or precision.
.It
A byte count or field precision
.Em is
-required for each ``s'' conversion
-character (unlike the
+required for each
+.Sq s
+conversion character (unlike the
.Xr fprintf 3
default which prints the entire string if the precision is unspecified).
.It
-The conversion characters ``h'', ``n'', and ``p'' are not
-supported.
+The conversion characters
+.Sq h ,
+.Sq n ,
+and
+.Sq p
+are not supported.
.It
The single character escape sequences
described in the C standard are supported:
@@ -224,8 +232,8 @@ octal, except for those representable by standard escape notation
which are displayed as two character strings.
.It Cm _p
Output characters in the default character set.
-Nonprinting characters are displayed as a single
-.Dq Cm \&. .
+Nonprinting characters are displayed as a single dot
+.Ql \&. .
.It Cm _u
Output US ASCII characters, with the exception that control characters are
displayed using the following, lower-case, names.
@@ -263,7 +271,9 @@ data required by each format unit, which is the iteration count times the
byte count, or the iteration count times the number of bytes required by
the format if the byte count is not specified.
.Pp
-The input is manipulated in ``blocks'', where a block is defined as the
+The input is manipulated in
+.Dq blocks ,
+where a block is defined as the
largest amount of data specified by any format string.
Format strings interpreting less than an input block's worth of data,
whose last format unit both interprets some number of bytes and does
@@ -298,9 +308,9 @@ output by an
conversion character with the same field width
and precision as the original conversion character or conversion
string but with any
-.Dq Li \&+ ,
-.Dq \&\ \& ,
-.Dq Li \&#
+.Ql + ,
+.Ql \&\ \& ,
+.Ql #
conversion flag characters
removed, and referencing a NULL string.
.Pp
@@ -324,6 +334,8 @@ Implement the \-x option:
"%07.7_Ax\en"
"%07.7_ax " 8/2 "%04x " "\en"
.Ed
+.Sh SEE ALSO
+.Xr od 1
.Sh STANDARDS
The
.Nm
diff --git a/usr.bin/hexdump/od.1 b/usr.bin/hexdump/od.1
index 392633fa153..a7970de3a13 100644
--- a/usr.bin/hexdump/od.1
+++ b/usr.bin/hexdump/od.1
@@ -1,4 +1,4 @@
-.\" $OpenBSD: od.1,v 1.6 1999/07/07 10:50:07 aaron Exp $
+.\" $OpenBSD: od.1,v 1.7 2000/03/07 21:11:10 aaron Exp $
.\" Copyright (c) 1990 The Regents of the University of California.
.\" All rights reserved.
.\"
@@ -68,8 +68,9 @@ or the
.Fl p ,
or
.Fl w
-options, nor is compatibility provided for the ``label'' component
-of the offset syntax.
+options, nor is compatibility provided for the
+.Dq label
+component of the offset syntax.
.Sh SEE ALSO
.Xr hexdump 1 ,
.Xr strings 1
diff --git a/usr.bin/id/groups.1 b/usr.bin/id/groups.1
index 457b1722f4e..e474dc146ed 100644
--- a/usr.bin/id/groups.1
+++ b/usr.bin/id/groups.1
@@ -1,4 +1,5 @@
-.\" $OpenBSD: groups.1,v 1.6 1999/07/07 10:50:07 aaron Exp $
+.\" $OpenBSD: groups.1,v 1.7 2000/03/07 21:11:10 aaron Exp $
+.\"
.\" Copyright (c) 1991, 1993
.\" The Regents of the University of California. All rights reserved.
.\"
@@ -34,7 +35,6 @@
.\"
.Dd June 6, 1993
.Dt GROUPS 1
-.UC
.Os
.Sh NAME
.Nm groups
@@ -48,9 +48,9 @@ The
utility has been obsoleted by the
.Xr id 1
utility, and is equivalent to
-.Dq Nm id Fl Gn Op Ar user .
+.Ic id Fl Gn Op Ar user .
The command
-.Dq Nm id Fl p
+.Ic id Fl p
is suggested for normal interactive use.
.Pp
The
diff --git a/usr.bin/id/id.1 b/usr.bin/id/id.1
index c849c14960b..3cff5c2b3de 100644
--- a/usr.bin/id/id.1
+++ b/usr.bin/id/id.1
@@ -1,4 +1,4 @@
-.\" $OpenBSD: id.1,v 1.8 2000/03/04 22:19:23 aaron Exp $
+.\" $OpenBSD: id.1,v 1.9 2000/03/07 21:11:10 aaron Exp $
.\" $NetBSD: id.1,v 1.5 1995/09/28 08:05:40 perry Exp $
.\"
.\" Copyright (c) 1991, 1993, 1994
@@ -94,14 +94,19 @@ If the user name returned by
is different from the login name referenced by the user ID, the name
returned by
.Xr getlogin 2
-is displayed, preceded by the keyword ``login''.
-The user ID as a name is displayed, preceded by the keyword ``uid''.
+is displayed, preceded by the keyword
+.Dq login .
+The user ID as a name is displayed, preceded by the keyword
+.Dq uid .
If the effective user ID is different from the real user ID, the real user
-ID is displayed as a name, preceded by the keyword ``euid''.
+ID is displayed as a name, preceded by the keyword
+.Dq euid .
If the effective group ID is different from the real group ID, the real group
-ID is displayed as a name, preceded by the keyword ``rgid''.
+ID is displayed as a name, preceded by the keyword
+.Dq rgid .
The list of groups to which the user belongs is then displayed as names,
-preceded by the keyword ``groups''.
+preceded by the keyword
+.Dq groups .
Each display is on a separate line.
.It Fl r
Display the real ID for the
@@ -128,13 +133,13 @@ The
historic
.Xr groups 1
command is equivalent to
-.Dq Nm id Fl Gn Op Ar user .
+.Ic id Fl Gn Op Ar user .
.Pp
The
historic
.Xr whoami 1
command is equivalent to
-.Dq Nm id Fl un .
+.Ic Nm id Fl un .
.Pp
The
.Nm
diff --git a/usr.bin/id/whoami.1 b/usr.bin/id/whoami.1
index e5d657ed221..9f774a3f980 100644
--- a/usr.bin/id/whoami.1
+++ b/usr.bin/id/whoami.1
@@ -1,4 +1,5 @@
-.\" $OpenBSD: whoami.1,v 1.6 1999/07/07 10:50:07 aaron Exp $
+.\" $OpenBSD: whoami.1,v 1.7 2000/03/07 21:11:10 aaron Exp $
+.\"
.\" Copyright (c) 1991, 1993
.\" The Regents of the University of California. All rights reserved.
.\"
@@ -38,7 +39,7 @@
.Os
.Sh NAME
.Nm whoami
-.Nd display effective user id
+.Nd display effective user ID
.Sh SYNOPSIS
.Nm whoami
.Sh DESCRIPTION
@@ -47,9 +48,9 @@ The
utility has been obsoleted by the
.Xr id 1
utility, and is equivalent to
-.Dq Nm id Fl un .
+.Ic id Fl un .
The command
-.Dq Nm id Fl p
+.Ic id Fl p
is suggested for normal interactive use.
.Pp
The