-.\" $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
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
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.
.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,
-.\" $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
.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.
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 .
.\" 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
.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};'
32,80,83,84,32,49,57,57,53,10
,0};
.Ed
-
-
+.Sh SEE ALSO
+.Xr hexdump 1 ,
+.Xr od 1
-.\" $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.
.\"
.Pp
Historically, the
.Fl d ,
-.Fl H
+.Fl H ,
and
.Fl x
options were implemented using the primaries
.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
-.\" $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.
.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
-.\" $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.
.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
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.
.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
.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
.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
-.\" $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
.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 .
.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
.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
-.\" $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.
.\"
.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.
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
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
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
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
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
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
.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
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.
-.\" $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
.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
.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
When
.Nm
is awaiting commands the prompt
-.Ql ftp>
+.Dq ftp>
is provided to the user.
The following commands are recognized
by
.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
.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.
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
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.
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
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
.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
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.
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
.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
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
.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
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
.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
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
.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.
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
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
.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
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
.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
.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
.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
.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 \&| ,
.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
.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
.Nm
supports only the default values for the remaining
file transfer parameters:
-.Ic mode ,
+.Ic mode ,
.Ic form ,
and
.Ic struct .
.Pa .netrc
file for any user other
than
-.Ar anonymous ,
+.Ar anonymous ,
.Nm
will abort the auto-login process if the
.Pa .netrc
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
-.\" $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
.\"
.\" (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
.Sh SYNOPSIS
.Nm gencat
.Ar output-file
-.Ar input-file Op Ar input-file...
+.Ar input-file Op Ar ...
.Sh DESCRIPTION
The
.Nm
.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 .
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
.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
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
.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.
.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 ,
-.\" $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.
.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.
-.\" $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
.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
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.
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
-.\" $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
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 .
.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
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.
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
-.\" $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.
.\"
-.\" $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.
.\"
.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
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
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
.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:
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.
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
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
"%07.7_Ax\en"
"%07.7_ax " 8/2 "%04x " "\en"
.Ed
+.Sh SEE ALSO
+.Xr od 1
.Sh STANDARDS
The
.Nm
-.\" $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.
.\"
.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
-.\" $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.
.\"
.\"
.Dd June 6, 1993
.Dt GROUPS 1
-.UC
.Os
.Sh NAME
.Nm groups
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
-.\" $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
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
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
-.\" $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.
.\"
.Os
.Sh NAME
.Nm whoami
-.Nd display effective user id
+.Nd display effective user ID
.Sh SYNOPSIS
.Nm whoami
.Sh DESCRIPTION
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
projects / openbsd / commitdiff