-.\" $OpenBSD: units.1,v 1.9 1999/06/13 16:31:18 pjanzen Exp $
+.\" $OpenBSD: units.1,v 1.10 2000/03/14 14:58:24 aaron Exp $
.\" converted to new format by deraadt@openbsd.org
.Dd July 14, 1993
.Dt UNITS 1
.Op Fl v
.Ar from-unit
.Ar to-unit
-.Sh ARGUMENTS
-.Bl -tag -width Ds
-.It Fl f Ar filename
-Specifies the name of the units data file to load.
-.It Fl q
-Suppresses prompting of the user for units and the display of statistics
-about the number of units loaded.
-.It Fl v
-Prints the version number.
-.It Ar from-unit Ar to-unit
-Allows a single unit conversion to be done directly from the command
-line. No prompting will occur. The units program will print out
-only the result of this single conversion.
-.El
.Sh DESCRIPTION
-The units program converts quantities expression in various scales to
-their equivalents in other scales. The units program can only
-handle multiplicative scale changes. It cannot convert Celsius
-to Fahrenheit, for example. It works interactively by prompting
-the user for input:
+The
+.Nm
+program converts quantities expression in various scales to
+their equivalents in other scales.
+The
+.Nm
+program can only handle multiplicative scale changes.
+It cannot convert Celsius
+to Fahrenheit, for example.
+It works interactively by prompting the user for input:
.Pp
.nf
You have: meters
/ 3785.4118
.fi
.Pp
+The options are as follows:
+.Bl -tag -width Ds
+.It Fl f Ar filename
+Specifies the name of the units data file to load.
+.It Fl q
+Suppresses prompting of the user for units and the display of statistics
+about the number of units loaded.
+.It Fl v
+Prints the version number.
+.It Ar from-unit Ar to-unit
+Allows a single unit conversion to be done directly from the command line.
+No prompting will occur.
+The units program will print out
+only the result of this single conversion.
+.El
+.Pp
Powers of units can be specified using the
.Ql ^
character as shown in
is equivalent to
.Sq cm^3 .
Multiplication of units can be specified by using spaces, a dash or
-an asterisk. Division of units is indicated by the slash
+an asterisk.
+Division of units is indicated by the slash
.Pq Ql / .
Note that multiplication has a higher precedence than division, so
.Sq m/s/s
2.1166667e-05 kg^2 m / sec
.fi
.Pp
-The conversion information is read from a units data file. The default
-file includes definitions for most familiar units, abbreviations and
-metric prefixes. Some constants of nature included are:
+The conversion information is read from a units data file.
+The default file includes definitions for most familiar units,
+abbreviations and metric prefixes.
+Some constants of nature included are:
.Bl -tag -width mercury
.It pi
ratio of circumference to diameter
.El
.Pp
.Sq Pound
-is a unit of mass. Compound names are run together
-so
+is a unit of mass.
+Compound names are run together so
.Sq poundforce
-is a unit of force. British units that differ from their
-US counterparts are prefixed with
+is a unit of force.
+British units that differ from their US counterparts are prefixed with
.Sq br ,
and currency is prefixed with its country name:
.Sq belgiumfranc ,
and check again for a match.
.Pp
All of these definitions can be read in the standard units file, or you
-can supply your own file. A unit is specified on a single line by
-giving its name and an equivalence. One should be careful to define
+can supply your own file.
+A unit is specified on a single line by
+giving its name and an equivalence.
+One should be careful to define
new units in terms of old ones so that a reduction leads to the
primitive units which are marked with
.Ql !
by careless unit definitions.
.Pp
Prefixes are defined in the same way as standard units, but with
-a trailing dash at the end of the prefix name. Prefixes are applied
+a trailing dash at the end of the prefix name.
+Prefixes are applied
after the longest matching unit name is found; for example,
.Dq nmile
is taken to be a nautical mile rather than a nanomile.
Exponents of units entered by the user can be only one digit.
You can work around this by multiplying several terms.
.Pp
-The user must use | to indicate division of numbers and / to
-indicate division of symbols. This distinction should not
-be necessary.
+The user must use
+.Ql |
+to indicate division of numbers and
+.Ql /
+to indicate division of symbols.
+This distinction should not be necessary.
.Pp
Prefixes specified without a unit are treated as dimensionless quantities.
This can lead to confusion when some prefixes are also defined as units
-(e.g., m). For example, Tera- / Giga- is 1000, but one Tesla (T) is 10,000
+(e.g., m).
+For example, Tera- / Giga- is 1000, but one Tesla (T) is 10,000
Gauss (G).
.Pp
Some non-SI units have multiple definitions (e.g, barrel, calorie) and
-others have changed over time (e.g., cubit). In particular, monetary
-values fluctuate.
+others have changed over time (e.g., cubit).
+In particular, monetary values fluctuate.
.Pp
The program contains various arbitrary limits on the length
of the units converted and on the length of the data file.
-.\" $OpenBSD: uuencode.1,v 1.6 1999/06/05 01:21:46 aaron Exp $
+.\" $OpenBSD: uuencode.1,v 1.7 2000/03/14 14:58:24 aaron Exp $
.\" $NetBSD: uuencode.1,v 1.4 1994/11/17 07:39:42 jtc Exp $
.\"
.\" Copyright (c) 1980, 1990, 1993
The resulting file is named
.Ar name
and will have the mode of the original file except that set-user-ID
-and execute bits are not retained. If the
+and execute bits are not retained.
+If the
.Fl p
option is specified, the output will instead be written to stdout.
.Nm uudecode
uuencodes it and mails it to a user on another system.
When
.Nm uudecode
-is run on the target system, the file ``src_tree.tar.Z'' will be
-created which may then be uncompressed and extracted into the original
-tree.
+is run on the target system, the file
+.Pa src_tree.tar.Z
+will be created which may then be uncompressed and extracted
+into the original tree.
.Pp
.Bd -literal -offset indent -compact
tar cf \- src_tree \&| compress \&|
uuencode src_tree.tar.Z \&| mail sys1!sys2!user
.Ed
-.Sh DIAGNOSTICS
-The
-.Nm uudecode
-and
-.Nm uuencode
-utilities exit 0 on success or >0 if an error occurred.
+.Pp
+Both utilities exit 0 on success or >0 if an error occurred.
.Sh SEE ALSO
.Xr compress 1 ,
.Xr mail 1 ,
-.\" $OpenBSD: uuencode.5,v 1.6 1999/05/23 14:11:06 aaron Exp $
+.\" $OpenBSD: uuencode.5,v 1.7 2000/03/14 14:58:24 aaron Exp $
.\" $NetBSD: uuencode.format.5,v 1.3 1994/11/17 07:39:45 jtc Exp $
.\"
.\" Copyright (c) 1989, 1991, 1993
.Xr uuencode 1
.Sh HISTORY
The
-.Nm uuencode
+.Nm
file format appeared in
.Bx 4.0 .
.\" It was named uuencode.5 prior to 4.3
-.\" $OpenBSD: vacation.1,v 1.12 1999/10/17 20:24:33 aaron Exp $
+.\" $OpenBSD: vacation.1,v 1.13 2000/03/14 14:58:24 aaron Exp $
.\" $NetBSD: vacation.1,v 1.5 1995/08/31 21:57:08 jtc Exp $
.\"
.\" Copyright (c) 1985, 1987, 1990, 1991, 1993
.Op Fl a Ar alias
.Ar login
.Sh DESCRIPTION
-.Nm vacation
+.Nm
returns a message to the sender of a message telling them that you
-are currently not reading your mail. The intended use is in a
+are currently not reading your mail.
+The intended use is in a
.Pa .forward
-file. For example, your
+file.
+For example, your
.Pa .forward
file might have:
.Bd -literal -offset indent
in the same manner as those received for the user's
login name.
.It Fl i
-Initialize the vacation database files. It should be used
-before you modify your
+Initialize the vacation database files.
+It should be used before you modify your
.Pa .forward
file.
.It Fl r
Set the reply interval to
.Ar interval
-days. The default is one week. An interval of
+days.
+The default is one week.
+An interval of
.Dq 0
means that
a reply is sent to each message, and an interval of
.Dq Li infinite
(actually, any non-numeric character) will never send more than
-one reply. It should be noted that intervals of
+one reply.
+It should be noted that intervals of
.Dq Li \&0
are quite
dangerous, as it allows mailers to get into
.Pa .vacation.db
in your home directory.
.Pp
-.Nm vacation
+.Nm
expects a file
.Pa .vacation.msg ,
in your home directory, containing a message to be sent back to each
-sender. It should be an entire message (including headers). For
-example, it might contain:
+sender.
+It should be an entire message (including headers).
+For example, it might contain:
.Pp
.Bd -unfilled -offset indent -compact
From: eric@CS.Berkeley.EDU (Eric Allman)
Delivered-By-The-Graces-Of: The Vacation program
Precedence: bulk
-I am on vacation until July 22. If you have something urgent,
+I am on vacation until July 22.
+If you have something urgent,
please contact Keith Bostic <bostic@CS.Berkeley.EDU>.
--eric
.Ed
in
.Pa .vacation.msg
will be replaced by the subject of the message that triggered the
-.Nm vacation
+.Nm
program.
.Pp
-.Nm vacation
+.Nm
reads the incoming message from standard input, checking the message
headers for either the
.Ux
.Dq From
line or a
.Dq Return-Path
-header to determine the sender. If both are present the sender from the
+header to determine the sender.
+If both are present the sender from the
.Dq Return-Path
header is used.
.Pp
Fatal errors, such as calling
-.Nm vacation
+.Nm
with incorrect arguments, or with non-existent
.Ar login Ns Ar s ,
are logged in the system log file, using
.Xr sendmail 8
.Sh HISTORY
The
-.Nm vacation
+.Nm
command appeared in
.Bx 4.3 .
-.\" $OpenBSD: vgrind.1,v 1.6 2000/03/06 03:17:40 aaron Exp $
+.\" $OpenBSD: vgrind.1,v 1.7 2000/03/14 14:58:25 aaron Exp $
.\" $NetBSD: vgrind.1,v 1.4 1994/11/17 08:28:04 jtc Exp $
.\"
.\" Copyright (c) 1980, 1990, 1993
.Nm
runs in two basic modes, filter mode (see the
.Fl f
-option) or regular mode. In filter mode
+option) or regular mode.
+In filter mode
.Nm
acts as a filter in a manner similar to
.Xr tbl 1 .
ends processing
.El
.Pp
-These lines are formatted as described above. The output from this
-filter can be passed to
+These lines are formatted as described above.
+The output from this filter can be passed to
.Xr troff 1
-for output. There need be no particular ordering with
+for output.
+There need be no particular ordering with
.Xr eqn 1
or
.Xr tbl 1 .
Specifies a particular header to put on every output page (default is
the file name).
.It Fl l
-Specifies the language to use. Currently known are
+Specifies the language to use.
+Currently known are
.Tn PASCAL
.Pq Fl l Ns Ar p ,
.Tn MODEL
For
.Tn C
\- function names can be preceded on a line only by spaces, tabs, or an
-asterisk. The parenthesized arguments must also be on the same line.
+asterisk.
+The parenthesized arguments must also be on the same line.
.Pp
For
.Tn PASCAL
More generally, arbitrary formatting styles for programs mostly look bad.
The use of spaces to align source code fails miserably; if you plan to
.Nm
-your program you should use tabs. This is somewhat inevitable since the
-font used by
+your program you should use tabs.
+This is somewhat inevitable since the font used by
.Nm
is variable width.
.Pp
-.\" $OpenBSD: vgrindefs.5,v 1.7 1999/07/09 13:35:30 aaron Exp $
+.\" $OpenBSD: vgrindefs.5,v 1.8 2000/03/14 14:58:25 aaron Exp $
.\" $NetBSD: vgrindefs.5,v 1.3 1994/11/17 08:28:07 jtc Exp $
.\"
.\" Copyright (c) 1989, 1991, 1993
.Ed
.Pp
Note that the first field is just the language name (and any variants
-of it). Thus the C language could be specified to
+of it).
+Thus the C language could be specified to
.Xr vgrind 1
-as "c" or "C".
+as
+.Qq c
+or
+.Qq C .
.Pp
Entries may continue onto multiple lines by giving a \e as the last
character of a line.
and string
capabilities which give a regular expression or
keyword list.
-.Sh REGULAR EXPRESSIONS
+.Sh REGULAR EXPRESSIONS
.Nm vgrindefs
uses regular expression which are very similar to those of
.Xr ex 1
and
.Xr lex 1 .
-The characters `^', `$', `:' and `\e'
+The characters
+.Ql ^ ,
+.Ql $ ,
+.Ql \&: ,
+and
+.Ql \e
are reserved characters and must be
-"quoted" with a preceding
+.Dq quoted
+with a preceding
.Ql \e
if they
are to be included as normal characters.
.It \ea
Matches any string of symbols (like .* in lex).
.It \ep
-Matches any alphanumeric name. In a procedure definition (pb) the string
+Matches any alphanumeric name.
+In a procedure definition (pb) the string
that matches this symbol is used as the procedure name.
.It ()
Grouping.
string delimiter in a string by escaping it.
.El
.Pp
-Unlike other regular expressions in the system, these match words
-and not characters. Hence something like "(tramp|steamer)flies?"
-would match "tramp", "steamer", "trampflies", or "steamerflies".
+Unlike other regular expressions in the system, these match words
+and not characters.
+Hence something like
+.Dq (tramp|steamer)flies?
+would match
+.Dq tramp ,
+.Dq steamer ,
+.Dq trampflies ,
+or
+.Dq steamerflies .
.Sh KEYWORD LIST
The keyword list is just a list of keywords in the language separated
-by spaces. If the "oc" boolean is specified, indicating that upper
+by spaces.
+If the
+.Dq oc
+boolean is specified, indicating that upper
and lower case are equivalent, then all the keywords should be
specified in lower case.
.Sh FILES
-.\" $OpenBSD: vis.1,v 1.5 1999/06/05 01:21:49 aaron Exp $
+.\" $OpenBSD: vis.1,v 1.6 2000/03/14 14:58:25 aaron Exp $
.\" $NetBSD: vis.1,v 1.5 1994/11/17 07:56:00 jtc Exp $
.\"
.\" Copyright (c) 1989, 1991, 1993, 1994
.Op Fl F Ar foldwidth
.Op Ar file ...
.Sh DESCRIPTION
-.Nm vis
+.Nm
is a filter for converting non-printable characters
-into a visual representation. It differs from
-.Ql cat -v
+into a visual representation.
+It differs from
+.Ic cat -v
in that
-the form is unique and invertible. By default, all non-graphic
+the form is unique and invertible.
+By default, all non-graphic
characters except space, tab, and newline are encoded.
A detailed description of the
various visual formats is given in
.Bl -tag -width Ds
.It Fl b
Turns off prepending of backslash before up-arrow control sequences
-and meta-characters, and disables the doubling of backslashes. This
-produces output which is neither invertible nor precise, but does
-represent a minimum of change to the input. It is similar to
-.Dq Li cat -v .
+and meta-characters, and disables the doubling of backslashes.
+This produces output which is neither invertible nor precise, but does
+represent a minimum of change to the input.
+It is similar to
+.Ic cat -v .
.It Fl c
Request a format which displays a small subset of the
non-printable characters using C-style backslash sequences.
.It Fl F
Causes
-.Nm vis
+.Nm
to fold output lines to foldwidth columns (default 80), like
.Xr fold 1 ,
except
.Fl f
or
.Fl F
-is selected. When combined with the
+is selected.
+When combined with the
.Fl f
flag,
-.Nm vis
+.Nm
becomes like
an invertible version of the
.Xr fold 1
-utility. That is, the output
+utility.
+That is, the output
can be unfolded by running the output through
.Xr unvis 1 .
.It Fl o
-.\" $OpenBSD: vmstat.8,v 1.14 1999/07/03 02:11:09 aaron Exp $
+.\" $OpenBSD: vmstat.8,v 1.15 2000/03/14 14:58:25 aaron Exp $
.\" $NetBSD: vmstat.8,v 1.12 1996/05/10 23:19:30 thorpej Exp $
.\"
.\" Copyright (c) 1986, 1993
.Op Fl w Ar wait
.Op disks
.Sh DESCRIPTION
-.Nm vmstat
+.Nm
reports certain kernel statistics kept about process, virtual memory,
-disk, trap and cpu activity.
+disk, trap and CPU activity.
.Pp
The options are as follows:
.Bl -tag -width "blah"
.El
.Pp
By default,
-.Nm vmstat
+.Nm
displays the following information just once:
.Bl -tag -width "whatever"
.It procs
.El
.Pp
.It Ar memory
-Information about the usage of virtual and real memory. Virtual pages
+Information about the usage of virtual and real memory.
+Virtual pages
(reported in units of 1024 bytes) are considered active if they belong
to processes which are running or have run in the last 20 seconds.
.Pp
The header of the field is the first character of the disk name and
the unit number.
If more than four disk drives are configured in the system,
-.Nm vmstat
+.Nm
displays only the first four drives.
To force
-.Nm vmstat
+.Nm
to display specific drives, their names may be supplied on the command line.
.Pp
.It Ar faults
.It Ar sy
system calls per interval
.It Ar cs
-cpu context switch rate (switches/interval)
+CPU context switch rate (switches/interval)
.El
.Pp
.It Ar cpu
.It Ar sy
system time
.It Ar id
-cpu idle
+CPU idle
.El
.El
.Sh EXAMPLES
-The command ``vmstat -w 5'' will print what the system is doing every five
+The command
+.Ic vmstat -w 5
+will print what the system is doing every five
seconds; this is a good choice of printing interval since this is how often
some of the statistics are sampled in the system.
Others vary every second and running the output for a while will make it
.Xr iostat 8 ,
.Xr pstat 8
.Pp
-The sections starting with ``Interpreting system activity'' in
+The sections starting with
+.Dq Interpreting system activity
+in
.%T "Installing and Operating 4.3BSD" .
.Sh BUGS
The
-.\" $OpenBSD: w.1,v 1.9 1999/08/12 19:26:39 millert Exp $
+.\" $OpenBSD: w.1,v 1.10 2000/03/14 14:58:25 aaron Exp $
.\"
.\" Copyright (c) 1980, 1990, 1991, 1993
.\" The Regents of the University of California. All rights reserved.
.Xr ps 1 ,
.Xr uptime 1 ,
.Xr who 1
+.Sh COMPATIBILITY
+The
+.Fl f ,
+.Fl l ,
+.Fl s ,
+and
+.Fl w
+flags are no longer supported.
+.Sh HISTORY
+The
+.Nm
+command appeared in
+.Bx 3.0 .
.Sh BUGS
The notion of the
.Dq current process
is muddy.
-The current algorithm is ``the highest numbered process on the terminal
+The current algorithm is
+``the highest numbered process on the terminal
that is not ignoring interrupts, or, if there is none, the highest numbered
-process on the terminal''.
+process on the terminal.''
This fails, for example, in critical sections of programs like the shell
and editor, or when faulty programs running in the background fork and fail
to ignore interrupts.
prints
.Dq \- . )
.Pp
-The
-.Tn CPU
-time is only an estimate, in particular, if someone leaves a background
+The CPU time is only an estimate.
+In particular, if someone leaves a background
process running after logging out, the person currently on that terminal is
.Dq charged
with the time.
utility does not know about the new conventions for detection of background
jobs.
It will sometimes find a background job instead of the right one.
-.Sh COMPATIBILITY
-The
-.Fl f ,
-.Fl l ,
-.Fl s ,
-and
-.Fl w
-flags are no longer supported.
-.Sh HISTORY
-The
-.Nm
-command appeared in
-.Bx 3.0 .
-.\" $OpenBSD: wall.1,v 1.5 1999/06/05 01:21:50 aaron Exp $
+.\" $OpenBSD: wall.1,v 1.6 2000/03/14 14:58:25 aaron Exp $
.\" $NetBSD: wall.1,v 1.3 1994/11/17 07:17:57 jtc Exp $
.\"
.\" Copyright (c) 1989, 1990, 1993
.Op Fl g Ar group
.Op Ar file
.Sh DESCRIPTION
-.Nm wall
+.Nm
displays the contents of
-.Ar file
+.Ar file ,
or, by default, its standard input, on the terminals of all
currently logged in users.
.Pp
terminals of users who have chosen
to deny messages or are using a program which
automatically denies messages.
+.Pp
+The options are as follows:
.Bl -tag -width indent
.It Fl g
-Send messages to users in this group. This option may be specified
+Send messages to users in this group.
+This option may be specified
multiple times, and any user in any of the specified groups will
receive the message.
.El
-.\" $OpenBSD: wc.1,v 1.8 2000/03/06 03:17:40 aaron Exp $
+.\" $OpenBSD: wc.1,v 1.9 2000/03/14 14:58:25 aaron Exp $
.\"
.\" Copyright (c) 1991, 1993
.\" The Regents of the University of California. All rights reserved.
.Op Ar file ...
.Sh DESCRIPTION
The
-.Nm wc
+.Nm
utility reads one or more input text files, and, by
default, writes the number of lines, words, and bytes
contained in each input file to the standard output.
If more than one input file is specified,
a line of cumulative count(s) for all named files is output on a
separate line following the last file count.
-.Nm wc
+.Nm
considers a word to be a maximal string of characters delimited by white
-space. White space characters are the set of characters for which the
+space.
+Whitespace characters are the set of characters for which the
.Xr isspace 3
function returns true.
.Pp
.El
.Pp
When an option is specified,
-.Nm wc
+.Nm
only reports the information requested by that option.
The default action is equivalent to the flags
.Fl clw
-having been specified. The
+having been specified.
+The
.Fl c
and
.Fl m
by spaces.
.Pp
The
-.Nm wc
+.Nm
utility exits 0 on success or >0 if an error occurred.
.Sh SEE ALSO
.Xr isspace 3
-.Sh STANDARDS
-The
-.Nm wc
-utility conforms to
-.St -p1003.2-92 .
-.Sh HISTORY
-A
-.Nm
-utility appeared in
-.At v1 .
.Sh COMPATIBILITY
Historically, the
-.Nm wc
+.Nm
utility was documented to define a word as a ``maximal string of
characters delimited by <space>, <tab> or <newline> characters''.
The implementation, however, didn't handle non-printing characters
counted as 8 characters.
4BSD systems after 4.3BSD modified the implementation to be consistent
with the documentation.
-This implementation defines a ``word'' in terms of the
+This implementation defines a
+.Dq word
+in terms of the
.Xr isspace 3
function, as required by
.St -p1003.2-92 .
+.Sh STANDARDS
+The
+.Nm
+utility conforms to
+.St -p1003.2-92 .
+.Sh HISTORY
+A
+.Nm
+utility appeared in
+.At v1 .
-.\" $OpenBSD: what.1,v 1.5 2000/03/06 03:17:41 aaron Exp $
+.\" $OpenBSD: what.1,v 1.6 2000/03/14 14:58:26 aaron Exp $
.\" $NetBSD: what.1,v 1.3 1994/11/17 06:59:38 jtc Exp $
.\"
.\" Copyright (c) 1980, 1991, 1993
.Nm what
.Ar name Op Ar ...
.Sh DESCRIPTION
-.Nm what
+.Nm
reads each file
.Ar name
and searches for sequences of the form
.Dq \&@(#)
-as inserted by the source code control system. It prints the remainder
+as inserted by the source code control system.
+It prints the remainder
of the string following this marker, up to a null character, newline, double
quote, or
-.Dq \&>
+.Ql >
character.
.Sh HISTORY
The
is not licensed to distribute
.Tn SCCS
this is a rewrite of the
-.Nm what
+.Nm
command which is part of
.Tn SCCS ,
and may not behave exactly the same as that
-.\" $OpenBSD: whatis.1,v 1.5 1999/10/07 19:15:25 aaron Exp $
+.\" $OpenBSD: whatis.1,v 1.6 2000/03/14 14:58:26 aaron Exp $
.\"
.\" Copyright (c) 1989, 1990, 1993
.\" The Regents of the University of California. All rights reserved.
.Op Fl m Ar path
.Ar command Op Ar ...
.Sh DESCRIPTION
-.Nm whatis
+.Nm
looks up a given command and gives the header line from the manual page.
You can then use the
.Xr man 1
.Bl -tag -width Fl
.It Fl M Ar path
Override the list of standard directories
-.Nm whatis
+.Nm
searches for its database named
.Dq Pa whatis.db .
The supplied
.Ar path
must be a colon
-.Dq \&:
+.Pq Ql \&:
separated list of directories.
This search path may also be set using the environment variable
.Ev MANPATH .
.It Fl m Ar path
Augment the list of standard directories
-.Nm whatis
+.Nm
searches for its database named
.Dq Pa whatis.db .
The supplied
.Ar path
-must be a colon
-.Dq \&:
-separated list of directories.
+must be a colon-separated list of directories.
These directories will be searched before the standard directories
or the directories supplied with the
.Fl M
environment variable are searched.
.El
.Sh ENVIRONMENT
+The following environment variables affect the execution of
+.Nm whatis :
.Bl -tag -width MANPATH
.It Ev MANPATH
The standard search path used by
-.\" $OpenBSD: whereis.1,v 1.6 2000/03/06 03:17:41 aaron Exp $
+.\" $OpenBSD: whereis.1,v 1.7 2000/03/14 14:58:26 aaron Exp $
.\" $NetBSD: whereis.1,v 1.4 1995/08/31 21:54:51 jtc Exp $
.\"
.\" Copyright (c) 1993
.Ar name Op Ar ...
.Sh DESCRIPTION
The
-.Nm whereis
+.Nm
utility checks the standard binary directories for the specified name,
printing out the paths of any it finds that are executable by the
user.
utility for the
.Dq user.cs_path
string.
-.Sh RETURN VALUES
+.Pp
The
.Nm
utility exits with one of the following values:
Some names were resolved but not all.
.It 2
No names were resolved.
-.It -1
+.It \-1
A system error occurred.
.El
.Sh SEE ALSO
.Xr locate 1 ,
.Xr which 1 ,
.Xr sysctl 8
+.Sh COMPATIBILITY
+The historic flags and arguments for the
+.Nm
+utility are no longer available in this version.
.Sh HISTORY
The
-.Nm whereis
+.Nm
command appeared in
.Bx 3.0 .
-.Sh COMPATIBILITY
-The historic flags and arguments for the
-.Nm whereis
-utility are no longer available in this version.
-.\" $OpenBSD: which.1,v 1.11 1999/10/07 19:15:25 aaron Exp $
+.\" $OpenBSD: which.1,v 1.12 2000/03/14 14:58:26 aaron Exp $
+.\"
.\" Copyright (c) 1980, 1991 Regents of the University of California.
.\" All rights reserved.
.\"
.Op Fl a
.Ar name Op Ar ...
.Sh DESCRIPTION
-.Nm which
+.Nm
takes a list of names and looks for the files which would be
executed had these names been given as commands.
Each argument is searched for along the user's path.
flag is given,
.Nm
will return a list of all matches instead of just the first match.
-.Sh RETURN VALUES
+.Pp
The
.Nm
utility exits with one of the following values:
Some names were resolved but not all.
.It 2
No names were resolved.
-.It -1
+.It \-1
A system error occurred.
.El
.Sh DIAGNOSTICS
A diagnostic is given if an executable file with the argument
name was not found in the path.
.Sh ENVIRONMENT
+The following environment variables affect the execution of
+.Nm which :
.Bl -tag -width PATH
.It Ev PATH
-.Nm
-uses the environment variable
-.Ev PATH
-as a colon-separated list of directories in which to find executables.
+A colon-separated list of directories in which to find executables.
If
.Ev PATH
is not set, and the given name is not a fully qualified
.Nm
will fail.
.El
-.Sh CAVEATS
-The
-.Nm
-command formerly was a
-.Xr csh 1
-script and could expand aliases.
-.Xr csh 1
-now has a built-in
-.Nm
-command so this version is intended for use
-with other shells like
-.Xr sh 1 .
.Sh SEE ALSO
.Xr csh 1 ,
.Xr find 1 ,
.Nm
command appeared in
.Bx 3.0 .
+.Sh CAVEATS
+The
+.Nm
+command formerly was a
+.Xr csh 1
+script and could expand aliases.
+.Xr csh 1
+now has a built-in
+.Nm
+command so this version is intended for use
+with other shells like
+.Xr sh 1 .
-.\" $OpenBSD: who.1,v 1.9 2000/03/06 03:17:41 aaron Exp $
+.\" $OpenBSD: who.1,v 1.10 2000/03/14 14:58:26 aaron Exp $
.\" $NetBSD: who.1,v 1.5 1994/12/07 04:28:47 jtc Exp $
.\"
.\" Copyright (c) 1986, 1991, 1993
The options are as follows:
.Bl -tag -width file
.It Fl m
-Only print information about the current terminal. This is the
+Only print information about the current terminal.
+This is the
.Tn POSIX
way of saying
.Nm
If
.Pa /var/log/wtmp
is being used as the file, the user name may be empty
-or one of the special characters `|', `}' and `~'. Logouts produce
-an output line without any user name. For more information on the
-special characters, see
+or one of the special characters
+.Ql | ,
+.Ql } ,
+and
+.Ql \&~ .
+Logouts produce an output line without any user name.
+For more information on the special characters, see
.Xr utmp 5 .
.Sh FILES
.Bl -tag -width /var/log/wtmp.[0-6] -compact
-.\" $OpenBSD: whois.1,v 1.12 2000/03/04 22:19:27 aaron Exp $
+.\" $OpenBSD: whois.1,v 1.13 2000/03/14 14:58:26 aaron Exp $
.\" $NetBSD: whois.1,v 1.5 1995/08/31 21:51:32 jtc Exp $
.\"
.\" Copyright (c) 1985, 1990, 1993
.Op Fl h Ar host
.Ar name Op Ar ...
.Sh DESCRIPTION
-.Nm whois
+.Nm
looks up records in the databases maintained by several
Network Information Centers
.Pq Tn NICs Ns .
.It Fl a
Use the American Registry for Internet Numbers
.Pq Tn ARIN
-database. It contains network numbers used in those parts of the world
+database.
+It contains network numbers used in those parts of the world
covered neither by
.Tn APNIC nor by
.Tn RIPE .
.It Fl d
Use the (US Military) Defense Data Network
.Pq Tn DDN
-database. It contains points of contact for subdomains of
+database.
+It contains points of contact for subdomains of
.Tn \&.MIL Ns .
.It Fl g
Use the US non-military federal government database, which contains points of
.It Fl i
Use the Network Solutions Registry for Internet Numbers
.Pq Tn InterNIC
-database. It contains network numbers and domain contact information
-for most of
+database.
+It contains network numbers and domain contact information for most of
.Tn \&.COM ,
.Tn \&.NET ,
.Tn \&.ORG
.It Fl p
Use the Asia/Pacific Network Information Center
.Pq Tn APNIC
-database. It contains network numbers used in East Asia, Australia,
+database.
+It contains network numbers used in East Asia, Australia,
New Zealand, and the Pacific islands.
.It Fl q
Construct the name of a whois server to use from the top-level domain
This option is now the default.
.Pp
.It Fl Q
-Do a quick lookup. This means that
+Do a quick lookup.
+This means that
.Nm
will not attempt to lookup the name in the authoratative whois
server (if one is listed) nor will it contact InterNic if a lookup
-fails. This flag has no effect when combined with any other flag.
+fails.
+This flag has no effect when combined with any other flag.
.It Fl r
Use the R\(aaeseaux IP Europ\(aaeens
.Pq Tn RIPE
-database. It contains network numbers and domain contact information
-for Europe.
+database.
+It contains network numbers and domain contact information for Europe.
.It Fl R
Use the Russia Network Information Center
.Pq Tn RIPN
-database. It contains network numbers and domain contact information
+database.
+It contains network numbers and domain contact information
for subdomains of
.Tn \&.RU Ns .
.El
.Pp
The operands specified to
-.Nm whois
+.Nm
are concatenated together (separated by whitespace) and presented to
the
-.Nm whois
+.Nm
server.
.Pp
The default action, unless directed otherwise with a special
.Ar name
operands have special meaning, and how to guide the search, use
the special name
-.Dq Ar help .
+.Dq help .
.Sh SEE ALSO
RFC 812: Nicname/Whois
.Sh HISTORY
The
-.Nm whois
+.Nm
command appeared in
.Bx 4.3 .
-.\" $OpenBSD: window.1,v 1.8 2000/03/06 03:17:41 aaron Exp $
+.\" $OpenBSD: window.1,v 1.9 2000/03/14 14:58:27 aaron Exp $
.\" $NetBSD: window.1,v 1.3 1995/09/28 10:35:05 tls Exp $
.\"
.\" Copyright (c) 1985, 1990, 1993
terminals.
.Pp
A window is a rectangular portion of the physical terminal
-screen associated with a set of processes. Its size and
-position can be changed by the user at any time. Processes
+screen associated with a set of processes.
+Its size and
+position can be changed by the user at any time.
+Processes
communicate with their window in the same way they normally
interact with a terminal - through their standard input, output,
-and diagnostic file descriptors. The window program handles the
+and diagnostic file descriptors.
+The window program handles the
details of redirecting input and output to and from the
-windows. At any one time, only one window can receive
+windows.
+At any one time, only one window can receive
input from the keyboard, but all windows can simultaneously send output
to the display.
.Pp
contained in the file
.Pa .windowrc
in the user's home directory are
-executed. If it does not exist, two equal sized windows spanning
+executed.
+If it does not exist, two equal sized windows spanning
the terminal screen are created by default.
.Pp
-The command line options are:
+The options are as follows:
.Bl -tag -width Fl
.It Fl t
Turn on terse mode (see
.Ic terse
command below).
.It Fl f
-Fast. Don't perform any startup action.
+Fast.
+Don't perform any startup action.
.It Fl d
Ignore
.Pa .windowrc
where
.Ar X
is any character, meaning
-.No control\- Ns Ar X .
+.No control\- Ns Ar X .
.It Fl c Ar command
Execute the string
.Ar command
before doing anything else.
.El
.Pp
-Windows can overlap and are framed as necessary. Each window
-is named by one of the digits 1\-9. This one-character
+Windows can overlap and are framed as necessary.
+Each window is named by one of the digits 1\-9.
+This one-character
identifier, as well as a user definable label string, are displayed
-with the window on the top edge of its frame. A window can be
-designated to be in the
-.Ar foreground ,
+with the window on the top edge of its frame.
+A window can be designated to be in the
+.Ar foreground ,
in which case it will always be
on top of all normal, non-foreground windows, and can be covered
-only by other foreground windows. A window need not be completely
-within the edges of the terminal screen. Thus a large window
+only by other foreground windows.
+A window need not be completely
+within the edges of the terminal screen.
+Thus a large window
(possibly larger than the screen) may be positioned to show only
a portion of its full size.
.Pp
-Each window has a cursor and a set of control functions. Most intelligent
-terminal operations such as line and
-character deletion and insertion are supported. Display modes
+Each window has a cursor and a set of control functions.
+Most intelligent terminal operations such as line and
+character deletion and insertion are supported.
+Display modes
such as underlining and reverse video are available if they are
-supported by the terminal. In addition,
-similar to terminals with multiple pages of memory,
+supported by the terminal.
+In addition, similar to terminals with multiple pages of memory,
each window has a text buffer which can have more lines than the window
itself.
.Ss Process Environment
With each newly created window, a shell program is spawned with its
-process environment tailored to that window. Its standard input,
+process environment tailored to that window.
+Its standard input,
output, and diagnostic file descriptors are bound to one end of either
a pseudo-terminal
.Xr (pty 4 )
characters and modes (see
.Xr stty 1 )
are copied from the physical
-terminal. A
+terminal.
+A
.Xr termcap 5
entry tailored to this window is created
and passed as environment
.Xr (environ 5 )
variable
-.Ev TERMCAP .
+.Ev TERMCAP .
The termcap entry contains the window's size and
characteristics as well as information from the physical terminal,
such as the existence of underline, reverse video, and other display
modes, and the codes produced by the terminal's function keys,
-if any. In addition, the window size attributes of the pseudo-terminal
+if any.
+In addition, the window size attributes of the pseudo-terminal
are set to reflect the size of this window, and updated whenever
-it is changed by the user. In particular, the editor
+it is changed by the user.
+In particular, the editor
.Xr vi 1
uses
this information to redraw its display.
During normal execution,
.Nm
can be in one of two states:
-conversation mode and command mode. In conversation mode, the
+conversation mode and command mode.
+In conversation mode, the
terminal's real cursor is placed at the cursor position of a particular
window--called the current window--and input from the keyboard is sent
-to the process in that window. The current window is always
-on top of all other windows, except those in foreground. In addition,
+to the process in that window.
+The current window is always
+on top of all other windows, except those in foreground.
+In addition,
it is set apart by highlighting its identifier and label in reverse video.
.Pp
Typing
escape character (normally
.Ic ^P )
in conversation
-mode switches it into command mode. In command mode, the top line of
+mode switches it into command mode.
+In command mode, the top line of
the terminal screen becomes the command prompt window, and
.Nm
interprets input from the keyboard as commands to manipulate windows.
.No control\- Ns Ar X ,
where
.Ar X
-is any character. In particular,
+is any character.
+In particular,
.Ic ^^
is
.Li control\-^ .
but stay in command mode.
.It Ic ^^
Select the previous window and return to conversation
-mode. This is useful for toggling between two windows.
+mode.
+This is useful for toggling between two windows.
.It Ic escape
Return to conversation mode.
.It Ic ^P
Return to conversation mode and write
.Ic ^P
to the
-current window. Thus, typing two
+current window.
+Thus, typing two
.Ic ^P Ns 's
in conversation
-mode sends one to the current window. If the
+mode sends one to the current window.
+If the
.Nm
escape is changed to some other character, that
character takes the place of
Suspend
.Nm window .
.It Ic w
-Create a new window. The user is prompted for the positions
+Create a new window.
+The user is prompted for the positions
of the upper left and lower right corners of the window.
The cursor is placed on the screen and the keys
.Sq h ,
and
.Sq L
move the cursor to the respective
-limits of the screen. Typing a number before the movement keys
-repeats the movement that number of times. Return enters the cursor position
-as the upper left corner of the window. The lower right corner
-is entered in the same manner. During this process,
+limits of the screen.
+Typing a number before the movement keys
+repeats the movement that number of times.
+Return enters the cursor position as the upper left corner of the window.
+The lower right corner
+is entered in the same manner.
+During this process,
the placement of the new window is indicated by a rectangular
box drawn on the screen, corresponding to where the new window
-will be framed. Typing escape at any point
-cancels this command.
+will be framed.
+Typing escape at any point cancels this command.
.Pp
This window becomes the current window,
-and is given the first available ID. The default buffer size
-is used (see
+and is given the first available ID.
+The default buffer size is used (see
.Ar default_nline
command below).
.Pp
.It Ic m Ns Ar #
Move window
.Ar #
-to another location. A box in the shape
-of the window is drawn on
+to another location.
+A box in the shape of the window is drawn on
the screen to indicate the new position of the window, and the same keys as
those for the
.Ic w
-command are used to position the box. The
-window can be moved partially off-screen.
+command are used to position the box.
+The window can be moved partially off-screen.
.It Ic M Ns Ar #
Move window
.Ar #
Change the size of window
.Ar # .
The user is prompted
-to enter the new lower right corner of the window. A box
-is drawn to indicate the new window size. The same
-keys used in
+to enter the new lower right corner of the window.
+A box is drawn to indicate the new window size.
+The same keys used in
.Ic w
and
.Ic m
.It Ic l
Move the cursor of the current window right by one column.
.It Ic y
-Yank. The user is prompted to enter two points within the current
-window. Then the content of the current window between those two points
+Yank.
+The user is prompted to enter two points within the current window.
+Then the content of the current window between those two points
is saved in the yank buffer.
.It Ic p
-Put. The content of the yank buffer is written to the current
-window as input.
+Put.
+The content of the yank buffer is written to the current window as input.
.It Ic ^S
Stop output in the current window.
.It Ic ^Q
.Ss Long Commands
Long commands are a sequence of statements
parsed much like a programming language, with a syntax
-similar to that of C. Numeric and string expressions and variables
+similar to that of C.
+Numeric and string expressions and variables
are supported, as well as conditional statements.
.Pp
-There are two data types: string and number. A string is a sequence
-of letters or digits beginning with a letter.
+There are two data types: string and number.
+A string is a sequence of letters or digits beginning with a letter.
.Ql _
and
.Ql \&.
-are considered letters. Alternately, non-alphanumeric characters can
+are considered letters.
+Alternately, non-alphanumeric characters can
be included in strings by quoting them in
.Ql \&"
or escaping them with
.Ql \en
is a newline,
.Ql \er
-a carriage return). For example, these are legal strings:
+a carriage return).
+For example, these are legal strings:
abcde01234, "&#$^*&#", ab"$#"cd, ab\\$\\#cd, "/usr/ucb/window".
.Pp
A number is an integer value in one of three forms:
.Sq 0X .
The natural
machine integer size is used (i.e., the signed integer type
-of the C compiler). As in C, a non-zero number represents
+of the C compiler).
+As in C, a non-zero number represents
a boolean true.
.Pp
The character
.Ql #
begins a comment which terminates at the end of the line.
.Pp
-A statement is either a conditional or an expression. Expression
-statements are terminated with a new line or
+A statement is either a conditional or an expression.
+Expression statements are terminated with a new line or
.Ql \&; .
To continue
an expression on the next line, terminate the first line with
.Nm
are similar to those in the
C language, with most C operators supported on numeric
-operands. In addition, some are overloaded to operate on strings.
+operands.
+In addition, some are overloaded to operate on strings.
.Pp
When an expression is used as a statement, its value is discarded
-after evaluation. Therefore, only expressions with side
+after evaluation.
+Therefore, only expressions with side
effects (assignments and function calls) are useful as statements.
.Pp
Single valued (no arrays) variables are supported, of both
-numeric and string values. Some variables are predefined. They
-are listed below.
+numeric and string values.
+Some variables are predefined.
+They are listed below.
.Pp
The operators in order of increasing precedence:
.Bl -tag -width Fl
.Ic =
.Aq Va expr2
.Xc
-Assignment. The variable of name
+Assignment.
+The variable of name
.Aq Va expr1 ,
which must be string valued,
is assigned the result of
evaluates true
(non-zero numeric value); returns the value of
.Aq Va expr3
-otherwise. Only
-one of
+otherwise.
+Only one of
.Aq Va expr2
and
.Aq Va expr3
.Ic \&|\&|
.Aq Va expr2
.Xc
-Logical or. Numeric values only. Short circuit evaluation is supported
-(i.e., if
+Logical or.
+Numeric values only.
+Short circuit evaluation is supported (i.e., if
.Aq Va expr1
evaluates true, then
.Aq Va expr2
.Ic \&&\&&
.Aq Va expr2
.Xc
-Logical and with short circuit evaluation. Numeric values only.
+Logical and with short circuit evaluation.
+Numeric values only.
.It Xo
.Aq Va expr1
.Ic \&|
.Aq Va expr2
.Xc
-Bitwise or. Numeric values only.
+Bitwise or.
+Numeric values only.
.It Xo
.Aq Va expr1
.Ic ^
.Aq Va expr2
.Xc
-Bitwise exclusive or. Numeric values only.
+Bitwise exclusive or.
+Numeric values only.
.It Xo
.Aq Va expr1
.Ic \&&
.Aq Va expr2
.Xc
-Bitwise and. Numeric values only.
+Bitwise and.
+Numeric values only.
.It Xo
.Aq Va expr1
.Ic ==
.Ic !=
.Aq expr2
.Xc
-Comparison (equal and not equal, respectively). The boolean
-result (either 1 or 0) of the comparison is returned. The
-operands can be numeric or string valued. One string operand
+Comparison (equal and not equal, respectively).
+The boolean
+result (either 1 or 0) of the comparison is returned.
+The operands can be numeric or string valued.
+One string operand
forces the other to be converted to a string in necessary.
.It Xo
.Aq Va expr1
.Aq Va expr2 ,
.Xc
Less than, greater than, less than or equal to,
-greater than or equal to. Both numeric and string values, with
-automatic conversion as above.
+greater than or equal to.
+Both numeric and string values, with automatic conversion as above.
.It Xo
.Aq Va expr1
.Ic <<
is bit
shifted left (or right) by
.Aq Va expr2
-bits. If
+bits.
+If
.Aq Va expr1
is
a string, then its first (or last)
.Ic -
.Aq Va expr2
.Xc
-Addition and subtraction on numbers. For
+Addition and subtraction on numbers.
+For
.Ql + ,
if one
argument is a string, then the other is converted to a string,
.Ic \&%
.Aq Va expr2
.Xc
-Multiplication, division, modulo. Numbers only.
+Multiplication, division, modulo.
+Numbers only.
.It Xo
.Ic \- Ns Aq Va expr ,
.Ic ~ Ns Aq Va expr ,
.Ic \&$? Ns Aq Va expr
.Xc
The first three are unary minus, bitwise complement and logical complement
-on numbers only. The operator,
+on numbers only.
+The operator,
.Ql $ ,
takes
.Aq Va expr
and returns
-the value of the variable of that name. If
+the value of the variable of that name.
+If
.Aq Va expr
is numeric
with value
prefix of the name of a built-in
.Nm
function
-or the full name of a user defined alias macro. In the case of a built-in
-function,
+or the full name of a user defined alias macro.
+In the case of a built-in function,
.Aq Ar arglist
can be in one of two forms:
.Bd -literal -offset indent
.Ed
.Pp
The two forms can in fact be intermixed, but the result is
-unpredictable. Most arguments can be omitted; default values will
-be supplied for them. The
+unpredictable.
+Most arguments can be omitted; default values will
+be supplied for them.
+The
.Ar argnames
can be unique prefixes
-of the argument names. The commas separating
+of the argument names.
+The commas separating
arguments are used only to disambiguate, and can usually be omitted.
.Pp
-Only the first argument form is valid for user defined aliases. Aliases
-are defined using the
+Only the first argument form is valid for user defined aliases.
+Aliases are defined using the
.Ic alias
-built-in function (see below). Arguments
-are accessed via a variant of the variable mechanism (see the
+built-in function (see below).
+Arguments are accessed via a variant of the variable mechanism (see the
.Ql $
operator above).
.Pp
Most functions return value, but some are used for side effect
-only and so must be used as statements. When a function or an alias is used
+only and so must be used as statements.
+When a function or an alias is used
as a statement, the parentheses surrounding
-the argument list may be omitted. Aliases return no value.
+the argument list may be omitted.
+Aliases return no value.
.El
-.Ss Built-in Functions
+.Ss Built-in functions
The arguments are listed by name in their natural
-order. Optional arguments are in square brackets
+order.
+Optional arguments are in square brackets
.Sq Op .
Arguments
that have no names are in angle brackets
.Bq Aq Ar string\-list Pc
.Xc
If no argument is given, all currently defined alias macros are
-listed. Otherwise,
+listed.
+Otherwise,
.Aq Ar string
is defined as an alias,
with expansion
.Aq Ar string\-list > .
The previous definition of
.Aq Ar string ,
-if any, is returned. Default for
+if any, is returned.
+Default for
.Aq Ar string\-list
is no change.
.It Ic close Ns Pq Aq Ar window\-list
If
.Aq Ar window\-list
is the word
-.Ar all ,
-than all windows are closed. No value is returned.
+.Ar all ,
+than all windows are closed.
+No value is returned.
.It Ic cursormodes Ns Pq Bq Ar modes
Set the window cursor to
-.Ar modes .
+.Ar modes .
.Ar Modes
is the bitwise
or of the mode bits defined as the variables
(blinking),
and
.Ar m_grp
-(graphics, terminal dependent). Return
-value is the previous modes. Default is no change.
+(graphics, terminal dependent).
+Return value is the previous modes.
+Default is no change.
For example,
.Li cursor($m_rev$m_blk)
sets the window cursors to blinking
reverse video.
.It Ic default_nline Ns Pq Bq Ar nline
Set the default buffer size to
-.Ar nline .
-Initially, it is
-48 lines. Returns the old default buffer size. Default is
-no change. Using a very large buffer can slow the program down
-considerably.
+.Ar nline .
+Initially, it is 48 lines.
+Returns the old default buffer size.
+Default is no change.
+Using a very large buffer can slow the program down considerably.
.It Ic default_shell Ns Pq Bq Aq Ar string\-list
Set the default window shell program to
.Aq Ar string\-list .
-Returns
-the first string in the old shell setting. Default is no change. Initially,
-the default shell is taken from the environment variable
-.Ev SHELL .
+Returns the first string in the old shell setting.
+Default is no change.
+Initially, the default shell is taken from the environment variable
+.Ev SHELL .
.It Ic default_smooth Ns Pq Bq Ar flag
Set the default value of the
.Ar smooth
argument
to the command
.Nm
-(see below). The argument
-is a boolean flag (one of
-.Ar on ,
-.Ar off ,
-.Ar yes ,
-.Ar no ,
-.Ar true ,
-.Ar false ,
+(see below).
+The argument is a boolean flag (one of
+.Ar on ,
+.Ar off ,
+.Ar yes ,
+.Ar no ,
+.Ar true ,
+.Ar false ,
or a number,
-as described above). Default is no change.
+as described above).
+Default is no change.
The old value (as a number) is returned.
The initial value is 1 (true).
.It Xo
to
.Nm window ,
separated
-by spaces and terminated with a new line. The strings are only
+by spaces and terminated with a new line.
+The strings are only
displayed in the window, the processes in the window are not
involved (see
.Ic write
-below). No value is returned. Default
-is the current window.
+below).
+No value is returned.
+Default is the current window.
.It Ic escape Ns Pq Bq Ar escapec
Set the escape character to
-.Ar escape-char .
+.Ar escape-char .
Returns the old
-escape character as a one-character string. Default is no
-change.
+escape character as a one-character string.
+Default is no change.
.Ar Escapec
can be a string of a single character, or
in the form
.Nm
in or out of foreground.
.Ar Flag
-is a boolean value. The old foreground flag
-is returned. Default for
+is a boolean value.
+The old foreground flag is returned.
+Default for
.Nm
is the current window,
default for
Set the label of
.Nm
to
-.Ar label .
-Returns the old
-label as a string. Default for
+.Ar label .
+Returns the old label as a string.
+Default for
.Nm
is the current
window, default for
.Ar label
-is no change. To turn
-off a label, set it to an empty string ("").
+is no change.
+To turn off a label, set it to an empty string ("").
.It Ic list Ns Pq
-No arguments. List the identifiers and labels of all windows. No
-value is returned.
+No arguments.
+List the identifiers and labels of all windows.
+No value is returned.
.It Ic select Ns Pq Bq Ar window
Make
.Nm
-the current window. The previous current window
-is returned. Default is no change.
+the current window.
+The previous current window is returned.
+Default is no change.
.It Ic source Ns Pq Ar filename
Read and execute the long commands in
-.Ar filename .
+.Ar filename .
Returns \-1 if the file cannot be read, 0 otherwise.
.It Ic terse Ns Pq Bq flag
Set terse mode to
-.Ar flag .
+.Ar flag .
In terse mode, the command window
stays hidden even in command mode, and errors are reported by
sounding the terminal's bell.
can take on the same
values as in
.Ar foreground
-above. Returns the old terse flag.
+above.
+Returns the old terse flag.
Default is no change.
.It Ic unalias Ns Pq Ar alias
Undefine
-.Ar alias .
+.Ar alias .
Returns -1 if
.Ar alias
does not exist,
0 otherwise.
.It Ic unset Ns Pq Ar variable
Undefine
-.Ar variable .
+.Ar variable .
Returns -1 if
.Ar variable
does not exist,
0 otherwise.
.It Ic variables Ns Pq
-No arguments. List all variables. No value is returned.
+No arguments.
+List all variables.
+No value is returned.
.It Xo
.Ic window Ns ( Bq Ar row ,
.Bq Ar column ,
.Bq Ar shell ) .
.Xc
Open a window with upper left corner at
-.Ar row ,
+.Ar row ,
.Ar column
and size
-.Ar nrow ,
-.Ar ncol .
+.Ar nrow ,
+.Ar ncol .
If
.Ar nline
is specified,
-then that many lines are allocated for the text buffer. Otherwise,
-the default buffer size is used. Default values for
-.Ar row ,
-.Ar column ,
-.Ar nrow ,
+then that many lines are allocated for the text buffer.
+Otherwise, the default buffer size is used.
+Default values for
+.Ar row ,
+.Ar column ,
+.Ar nrow ,
and
.Ar ncol
are, respectively,
screen.
.Ar Label
is the label string.
-.Ar Frame ,
-.Ar pty ,
+.Ar Frame ,
+.Ar pty ,
and
.Ar mapnl
are flag values
true), and map new line characters in this window to carriage return
and line feed (default true if socketpair is used, false otherwise).
Normally, a window is automatically closed when its process
-exits. Setting
+exits.
+Setting
.Ar keepopen
to true (default false) prevents this
-action. When
+action.
+When
.Ar smooth
is true, the screen is updated more frequently
(for this window) to produce a more terminal-like behavior.
program to place in the window (default is the program specified
by
.Ar default_shell ,
-see above). The created window's identifier
-is returned as a number.
+see above).
+The created window's identifier is returned as a number.
.It Xo
.Ic write Ns ( Bq Ar window ,
.Bq Aq Ar string\-list )
to
.Nm window ,
separated
-by spaces but not terminated with a new line. The strings are actually
-given to the window as input. No value is returned. Default
-is the current window.
+by spaces but not terminated with a new line.
+The strings are actually given to the window as input.
+No value is returned.
+Default is the current window.
.El
.Ss Predefined Variables
-These variables are for information only. Redefining them does
-not affect the internal operation of
+These variables are for information only.
+Redefining them does not affect the internal operation of
.Nm window .
.Bl -tag -width modes
.It Ar baud
The baud rate as a number between 50 and 38400.
.It Ar modes
The display modes (reverse video, underline, blinking, graphics)
-supported by the physical terminal. The value of
+supported by the physical terminal.
+The value of
.Ar modes
is the bitwise or of some of the one bit values,
.Ar m_blk ,
.It Ar nrow
The number of rows on the physical screen.
.It Ar term
-The terminal type. The standard name, found in the second name
-field of the terminal's
+The terminal type.
+The standard name, found in the second name field of the terminal's
.Ev TERMCAP
entry, is used.
.Sh ENVIRONMENT
-.\" $OpenBSD: write.1,v 1.6 2000/03/06 03:17:41 aaron Exp $
+.\" $OpenBSD: write.1,v 1.7 2000/03/14 14:58:27 aaron Exp $
+.\"
.\" Copyright (c) 1989, 1993
.\" The Regents of the University of California. All rights reserved.
.\"
.Ar user
.Op Ar ttyname
.Sh DESCRIPTION
-.Nm write
+.Nm
allows you to communicate with other users, by copying lines from
your terminal to theirs.
.Pp
When you run the
-.Nm write
+.Nm
command, the user you are writing to gets a message of the form:
.Pp
.Dl Message from yourname@yourhost on yourtty at hh:mm ...
Any further lines you enter will be copied to the specified user's
terminal.
If the other user wants to reply, they must run
-.Nm write
+.Nm
as well.
.Pp
When you are done, type an end-of-file or interrupt character.
The other user will see the message
-.Ql EOF
-indicating that the
-conversation is over.
+.Dq EOF
+indicating that the conversation is over.
.Pp
-You can prevent people (other than the super-user) from writing to you
+You can prevent people (other than the superuser) from writing to you
with the
.Xr mesg 1
command.
If the user you want to write to is logged in on more than one terminal,
you can specify which terminal to write to by specifying the terminal
name as the second operand to the
-.Nm write
+.Nm
command.
Alternatively, you can let
-.Nm write
+.Nm
select one of the terminals \- it will pick the one with the shortest
idle time.
This is so that if the user is logged in at work and also dialed up from
home, the message will go to the right place.
.Pp
The traditional protocol for writing to someone is that the string
-.Ql \-o ,
+.Dq \-o ,
either at the end of a line or on a line by itself, means that it's the
other person's turn to talk.
The string
-.Ql oo
+.Dq oo
means that the person believes the conversation to be
over.
.Sh SEE ALSO
.At v6 .
.Sh BUGS
The
-.Ql EOF
+.Dq EOF
message seen when the other
-.Nm write
+.Nm
terminates is indistinguishable from that party simply typing
-.Ql EOF
+.Dq EOF
to make you believe that any future messages did not come from them.
Especially messages such as:
+.Pp
.Dl "[1] Done rm -rf *"
-.\" $OpenBSD: xargs.1,v 1.8 2000/01/20 07:18:25 deraadt Exp $
+.\" $OpenBSD: xargs.1,v 1.9 2000/03/14 14:58:27 aaron Exp $
.\" $NetBSD: xargs.1,v 1.6 1994/11/14 06:51:40 jtc Exp $
.\"
.\" Copyright (c) 1990, 1991, 1993
.Ar utility
cannot be invoked, an invocation of the utility is terminated by a signal,
or an invocation of the utility exits with a value of 255.
-.Sh DIAGNOSTICS
+.Pp
.Nm
exits with one of the following values:
.Pp
-.\" $OpenBSD: install.1,v 1.10 1999/10/17 20:35:48 aaron Exp $
+.\" $OpenBSD: install.1,v 1.11 2000/03/14 14:58:27 aaron Exp $
.\" $NetBSD: install.1,v 1.4 1994/11/14 04:57:17 jtc Exp $
.\"
.\" Copyright (c) 1987, 1990, 1993
If the target file already exists and the files are the same,
then don't change the modification time of the target.
.It Fl c
-Copy the file. This is actually the default. The
+Copy the file.
+This is actually the default.
+The
.Fl c
option is only included for backwards compatibility.
.It Fl d
.Xr chflags 1
for a list of possible flags and their meanings.)
.It Fl g
-Specify a group. A numeric GID is allowed.
+Specify a group.
+A numeric GID is allowed.
.It Fl m
Specify an alternate mode.
The default mode is set to rwxr-xr-x (0755).
The specified mode may be either an octal or symbolic value; see
-.Xr chmod 1
+.Xr chmod 1
for a description of possible mode values.
.It Fl o
-Specify an owner. A numeric UID is allowed.
+Specify an owner.
+A numeric UID is allowed.
.It Fl p
Preserve the modification time.
Copy the file, as if the
except if the target file doesn't already exist or is different,
then preserve the modification time of the file.
.It Fl S
-Safe copy. Normally,
-.Nm install
-unlinks an existing target before installing the new file. With the
+Safe copy.
+Normally,
+.Nm
+unlinks an existing target before installing the new file.
+With the
.Fl S
flag a temporary file is used and then renamed to be
-the target. The reason this is safer is that if the copy or
+the target.
+The reason this is safer is that if the copy or
rename fails, the existing target is left untouched.
.It Fl s
-.Nm install
+.Nm
exec's the command
.Pa /usr/bin/strip
to strip binaries so that install can be portable over a large
-number of systems and binary types. If the environment variable
+number of systems and binary types.
+If the environment variable
.Ev STRIP
is set, it is used instead.
.El
.Pp
By default,
-.Nm install
-preserves all file flags, with the exception of the ``nodump'' flag.
+.Nm
+preserves all file flags, with the exception of the
+.Dq nodump
+flag.
.Pp
The
-.Nm install
+.Nm
utility attempts to prevent moving a file onto itself.
.Pp
Installing
.Xr mkstemp 3 ,
are created in the target directory.
.Sh ENVIRONMENT
-.Nm
-utilizes the following environment variables.
+The following environment variables affect the execution of
+.Nm install :
.Bl -tag -width "STRIP"
.It Ev STRIP
For an alternate
.Xr strip 1
-program to run. Default is
+program to run.
+Default is
.Pa /usr/bin/strip .
.Sh SEE ALSO
.Xr chflags 1 ,
.Xr chown 8
.Sh HISTORY
The
-.Nm install
+.Nm
utility appeared in
.Bx 4.2 .
.Sh CAVEATS
flags are non-standard and should not relied upon for portability.
.Pp
Temporary files may be left in the target directory if
-.Nm install
+.Nm
exits abnormally.
-.\" $OpenBSD: xstr.1,v 1.7 2000/03/06 03:17:41 aaron Exp $
+.\" $OpenBSD: xstr.1,v 1.8 2000/03/14 14:58:27 aaron Exp $
.\" $NetBSD: xstr.1,v 1.4 1994/11/26 09:25:22 jtc Exp $
.\"
.\" Copyright (c) 1980, 1993
Repeated strings and strings which are suffixes of existing strings
do not cause changes to the data base.
.It Fl l Ar array
-Specify the named array in program references to abstracted
-strings. The default array name is xstr.
+Specify the named array in program references to abstracted strings.
+The default array name is
+.Dq xstr .
.El
.Pp
After all components of a large program have been compiled a file
.It Pa x.c
massaged C source
.It Pa xs.c
-C source for definition of array `xstr'
+C source for definition of array
+.Dq xstr
.It Pa /tmp/xs*
-temporary file when `xstr name' doesn't touch
+temporary file when
+.Dq xstr name
+doesn't touch
.Pa strings
.El
.Sh SEE ALSO
-.\" $OpenBSD: yacc.1,v 1.9 2000/03/05 00:28:56 aaron Exp $
+.\" $OpenBSD: yacc.1,v 1.10 2000/03/14 14:58:27 aaron Exp $
+.\"
.\" Copyright (c) 1989, 1990 The Regents of the University of California.
.\" All rights reserved.
.\"
.Op Fl p Ar symbol_prefix
.Ar filename
.Sh DESCRIPTION
-.Nm yacc
+.Nm
reads the grammar specification in the file
.Ar filename
and generates an
.Tn LALR(1)
parsing tables and a driver routine
written in the C programming language.
-.Nm yacc
+.Nm
normally writes the parse tables and the driver routine to the file
.Pa y.tab.c .
.Pp
If the
.Fl l
option is not specified,
-.Nm yacc
+.Nm
will insert #line directives in the generated code.
The #line directives let the C compiler relate errors in the
generated code to the user's original code.
If the
.Fl l
option is specified,
-.Nm yacc
+.Nm
will not insert the #line directives.
#line directives specified by the user will be retained.
.It Fl o Ar output_file
The
.Fl r
option causes
-.Nm yacc
+.Nm
to produce separate files for code and tables.
The code file is named
.Pa y.code.c ,
The
.Fl t
option changes the preprocessor directives generated by
-.Nm yacc
+.Nm
so that debugging statements will be incorporated in the compiled code.
.It Fl v
The
be written to the file
.Pa y.output .
.Sh ENVIRONMENT
-The following environment variable is referenced by
+The following environment variables affect the execution of
.Nm yacc :
.Bl -tag -width TMPDIR
.It Ev TMPDIR
-If the environment variable
-.Ev TMPDIR
-is set, the string denoted by
-.Ev TMPDIR
-will be used as the name of the directory where the temporary
-files are created.
+Name of directory where temporary files are to be created.
.El
.Sh TABLES
The names of the tables generated by this version of
-.Nm yacc
+.Nm
are
.Dq yylhs ,
.Dq yylen ,
are created if
.Dv YYDEBUG
is defined and non-zero.
+.Sh DIAGNOSTICS
+If there are rules that are never reduced, the number of such rules is
+written to the standard error.
+If there are any
+.Tn LALR(1)
+conflicts, the number of conflicts is also written
+to the standard error.
.Sh FILES
.Bl -tag -width /tmp/yacc.uXXXXXXXXXX -compact
.It Pa y.code.c
.It Pa /tmp/yacc.tXXXXXXXXXX
.It Pa /tmp/yacc.uXXXXXXXXXX
.El
-.Sh DIAGNOSTICS
-If there are rules that are never reduced, the number of such rules is
-written to the standard error.
-If there are any
-.Tn LALR(1)
-conflicts, the number of conflicts is also written
-to the standard error.
.Sh SEE ALSO
.Xr yyfix 1
.Sh STANDARDS
The
-.Nm yacc
+.Nm
utility conforms to
.St -p1003.2 .
-.\" $OpenBSD: ypwhich.1,v 1.8 1999/06/05 01:21:52 aaron Exp $
+.\" $OpenBSD: ypwhich.1,v 1.9 2000/03/14 14:58:27 aaron Exp $
.\" $NetBSD: ypwhich.1,v 1.3 1996/05/13 02:43:46 thorpej Exp $
.\"
.\" Copyright (c) 1994 Christopher G. Demetriou
.\" (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: ypwhich.1,v 1.8 1999/06/05 01:21:52 aaron Exp $
+.\" $Id: ypwhich.1,v 1.9 2000/03/14 14:58:27 aaron Exp $
.\"
.Dd February 23, 1994
.Dt YPWHICH 1
.It Fl m Op Ar mname
Find the master
.Tn YP
-server for the named map. No
+server for the named map.
+No
.Ar host
may be specified with the
.Fl m
option.
.Ar Mname
-can be a map name or nickname. If
+can be a map name or nickname.
+If
.Ar mname
is omitted,
.Nm
.Xr ypset 8
.Sh AUTHOR
Theo De Raadt
-
-
projects / openbsd / commitdiff