Mechanically kill hard sentence breaks.

This commit is contained in:
Ruslan Ermilov 2004-07-02 22:22:35 +00:00
parent f97d4ddfed
commit 6a3e8b0adc
81 changed files with 973 additions and 499 deletions

View File

@ -60,7 +60,8 @@ object files that are produced.
.It Fl D Ar name Ns Op = Ns Ar value .It Fl D Ar name Ns Op = Ns Ar value
Define name as if by a C-language Define name as if by a C-language
.Ic #define .Ic #define
directive. If directive.
If
no no
.Dq = Ns Ar value .Dq = Ns Ar value
is given, a value of 1 will be used. is given, a value of 1 will be used.
@ -69,11 +70,13 @@ translation as specified by
.St -p1003.2 .St -p1003.2
you need to define you need to define
.Dv _POSIX_SOURCE .Dv _POSIX_SOURCE
either in the source or using this option. The either in the source or using this option.
The
.Fl D .Fl D
option has lower precedence than the option has lower precedence than the
.Fl U .Fl U
option. That is, if option.
That is, if
.Ar name .Ar name
is used in both a is used in both a
.Fl U .Fl U
@ -81,7 +84,8 @@ and a
.Fl D .Fl D
option, option,
.Ar name .Ar name
will be undefined regardless of the order of the options. The will be undefined regardless of the order of the options.
The
.Fl D .Fl D
option may be specified more than once. option may be specified more than once.
.It Fl E .It Fl E
@ -93,20 +97,24 @@ Produce symbolic information in the object or executable files.
Change the algorithm for searching for headers whose names are not Change the algorithm for searching for headers whose names are not
absolute pathnames to look in the directory named by the absolute pathnames to look in the directory named by the
.Ar directory .Ar directory
pathname before looking in the usual places. Thus, headers whose pathname before looking in the usual places.
Thus, headers whose
names are enclosed in double-quotes ("") will be searched for first names are enclosed in double-quotes ("") will be searched for first
in the directory of the file with the in the directory of the file with the
.Ic #include .Ic #include
line, then in line, then in
directories named in directories named in
.Fl I .Fl I
options, and last in the usual places. For options, and last in the usual places.
For
headers whose names are enclosed in angle brackets (<>), the header headers whose names are enclosed in angle brackets (<>), the header
will be searched for only in directories named in will be searched for only in directories named in
.Fl I .Fl I
options and then in the usual places. Directories named in options and then in the usual places.
Directories named in
.Fl I .Fl I
options shall be searched in the order specified. The options shall be searched in the order specified.
The
.Fl I .Fl I
option may be specified more than once. option may be specified more than once.
.It Fl L Ar directory .It Fl L Ar directory
@ -114,9 +122,11 @@ Change the algorithm of searching for the libraries named in the
.Fl l .Fl l
objects to look in the directory named by the objects to look in the directory named by the
.Ar directory .Ar directory
pathname before looking in the usual places. Directories named in pathname before looking in the usual places.
Directories named in
.Fl L .Fl L
options will be searched in the order specified. The options will be searched in the order specified.
The
.Fl L .Fl L
option may be specified more than once. option may be specified more than once.
.It Fl o Ar outfile .It Fl o Ar outfile
@ -141,11 +151,14 @@ option may be specified more than once.
.Pp .Pp
An operand is either in the form of a pathname or the form An operand is either in the form of a pathname or the form
.Fl l .Fl l
library. At least one operand of the pathname form needs to be library.
specified. Supported operands are of the form: At least one operand of the pathname form needs to be
specified.
Supported operands are of the form:
.Bl -tag -offset indent -width "-l library" .Bl -tag -offset indent -width "-l library"
.It Ar file Ns Pa .c .It Ar file Ns Pa .c
A C-language source file to be compiled and optionally linked. The A C-language source file to be compiled and optionally linked.
The
operand must be of this form if the operand must be of this form if the
.Fl c .Fl c
option is used. option is used.

View File

@ -128,7 +128,7 @@ or negative integer.
``Paskha'', is Orthodox Easter for this year, and may be followed by a ``Paskha'', is Orthodox Easter for this year, and may be followed by a
positive or negative integer. positive or negative integer.
.Pp .Pp
Weekdays may be followed by ``-4'' ... ``+5'' (aliases for Weekdays may be followed by ``-4'' ...\& ``+5'' (aliases for
last, first, second, third, fourth) for moving events like last, first, second, third, fourth) for moving events like
``the last Monday in April''. ``the last Monday in April''.
.Pp .Pp
@ -217,7 +217,7 @@ Calendar of events in France.
.It Pa calendar.german .It Pa calendar.german
Calendar of events in Germany. Calendar of events in Germany.
.It Pa calendar.history .It Pa calendar.history
Everything else, mostly U.S. historical events. Everything else, mostly U.S.\& historical events.
.It Pa calendar.holiday .It Pa calendar.holiday
Other holidays, including the not-well-known, obscure, and Other holidays, including the not-well-known, obscure, and
.Em really .Em really
@ -236,7 +236,7 @@ Russian calendar.
.It Pa calendar.southafrica .It Pa calendar.southafrica
Calendar of events in South Africa. Calendar of events in South Africa.
.It Pa calendar.usholiday .It Pa calendar.usholiday
U.S. holidays. U.S.\& holidays.
This calendar should be updated yearly by the local system administrator This calendar should be updated yearly by the local system administrator
so that roving holidays are set correctly for the current year. so that roving holidays are set correctly for the current year.
.It Pa calendar.world .It Pa calendar.world

View File

@ -90,11 +90,11 @@ size changes.
Delimiters checked are: Delimiters checked are:
.Bl -enum .Bl -enum
.It .It
Font changes using \efx ... \efP. Font changes using \efx ...\& \efP.
.It .It
Size changes using \esx ... \es0. Size changes using \esx ...\& \es0.
.It .It
Macros that come in open ... close forms, for example, Macros that come in open ...\& close forms, for example,
the .TS and .TE macros which must always come in pairs. the .TS and .TE macros which must always come in pairs.
.El .El
.Pp .Pp

View File

@ -163,7 +163,8 @@ Both of these fields should be unique across the system (and often
across a group of systems) as they control file access. across a group of systems) as they control file access.
.Pp .Pp
While it is possible to have multiple entries with identical login names While it is possible to have multiple entries with identical login names
and/or identical user id's, it is usually a mistake to do so. Routines and/or identical user id's, it is usually a mistake to do so.
Routines
that manipulate these files will often return only one of the multiple that manipulate these files will often return only one of the multiple
entries, and that one by random selection. entries, and that one by random selection.
.Pp .Pp
@ -447,7 +448,8 @@ When invoked by the super-user on the NIS master server,
allows unrestricted changes to the NIS passwd maps using dedicated, allows unrestricted changes to the NIS passwd maps using dedicated,
non-RPC-based mechanism (in this case, a non-RPC-based mechanism (in this case, a
.Ux .Ux
domain socket). The domain socket).
The
.Fl o .Fl o
flag can be used to force flag can be used to force
.Nm .Nm

View File

@ -128,7 +128,8 @@ If it is increasing,
continues to use the existing code dictionary. continues to use the existing code dictionary.
However, if the compression ratio decreases, However, if the compression ratio decreases,
.Nm .Nm
discards the table of substrings and rebuilds it from scratch. This allows discards the table of substrings and rebuilds it from scratch.
This allows
the algorithm to adapt to the next "block" of the file. the algorithm to adapt to the next "block" of the file.
.Pp .Pp
The The

View File

@ -72,11 +72,13 @@ This is the default.
.It Fl a .It Fl a
Display an entry for each file in a file hierarchy. Display an entry for each file in a file hierarchy.
.It Fl h .It Fl h
"Human-readable" output. Use unit suffixes: Byte, Kilobyte, Megabyte, "Human-readable" output.
Use unit suffixes: Byte, Kilobyte, Megabyte,
Gigabyte, Terabyte and Petabyte Gigabyte, Terabyte and Petabyte
.It Fl r .It Fl r
Generate messages about directories that cannot be read, files Generate messages about directories that cannot be read, files
that cannot be opened, and so on. This is the default case. that cannot be opened, and so on.
This is the default case.
This option exists solely for conformance with This option exists solely for conformance with
.St -xpg4 . .St -xpg4 .
.It Fl s .It Fl s

View File

@ -20,9 +20,11 @@
The The
.Nm .Nm
utility utility
is a simple screen oriented text editor. It is always in text insertion is a simple screen oriented text editor.
It is always in text insertion
mode unless there is a prompt at the bottom of the terminal, or a mode unless there is a prompt at the bottom of the terminal, or a
menu present (in a box in the middle of the terminal). The menu present (in a box in the middle of the terminal).
The
.Nm ree .Nm ree
utility is the same as utility is the same as
.Nm , .Nm ,
@ -33,12 +35,14 @@ For
.Nm .Nm
to work properly, the environment variable to work properly, the environment variable
.Ev TERM .Ev TERM
must be set to indicate the type of terminal being used. For must be set to indicate the type of terminal being used.
For
example, for an example, for an
.Tn HP 700/92 .Tn HP 700/92
terminal, the terminal, the
.Ev TERM .Ev TERM
variable should be set to "70092". See your System Administrator if variable should be set to "70092".
See your System Administrator if
you need more information. you need more information.
.Pp .Pp
The following options are available: The following options are available:
@ -67,7 +71,8 @@ arrow keys, etc.).
Since not all terminals have function keys, Since not all terminals have function keys,
.Nm .Nm
has the basic cursor movement functions assigned to control keys as has the basic cursor movement functions assigned to control keys as
well as more intuitive keys on the keyboard when available. For well as more intuitive keys on the keyboard when available.
For
instance, to move the cursor up, the user can use the up arrow key, instance, to move the cursor up, the user can use the up arrow key,
or or
.Em ^u . .Em ^u .
@ -126,9 +131,11 @@ Pop up menu.
.Ss "EMACS keys mode" .Ss "EMACS keys mode"
Since many shells provide an Emacs mode (for cursor movement and other editing Since many shells provide an Emacs mode (for cursor movement and other editing
operations), some bindings that may be more useful for people familiar with operations), some bindings that may be more useful for people familiar with
those bindings have been provided. These are accessible via the those bindings have been provided.
These are accessible via the
.Em settings .Em settings
menu, or via the initialization file (see below). The mappings are as follows: menu, or via the initialization file (see below).
The mappings are as follows:
.Bl -tag -width indent .Bl -tag -width indent
.It ^a .It ^a
Move to the beginning of the line. Move to the beginning of the line.
@ -196,10 +203,12 @@ Move the cursor in the direction indicated.
.El .El
.Ss Commands .Ss Commands
Some operations require more information than a single keystroke can Some operations require more information than a single keystroke can
provide. For the most basic operations, there is a menu that can be provide.
For the most basic operations, there is a menu that can be
obtained by pressing the obtained by pressing the
.Tn ESC .Tn ESC
key. The same operations, and more can be performed by obtaining the key.
The same operations, and more can be performed by obtaining the
command prompt (^c) and typing in one of the commands below. command prompt (^c) and typing in one of the commands below.
.Bl -tag -width indent .Bl -tag -width indent
.It ! Ns Ar cmd .It ! Ns Ar cmd
@ -242,8 +251,10 @@ key (or
.Em ^[ .Em ^[
if no if no
.Em escape .Em escape
key is present). When in the menu, the escape key can be key is present).
used to leave the menu without performing any operations. Use the up and When in the menu, the escape key can be
used to leave the menu without performing any operations.
Use the up and
down arrow keys, or down arrow keys, or
.Em ^u .Em ^u
for moving up and for moving up and
@ -272,11 +283,14 @@ the editor to a print command (see the section
.It redraw screen .It redraw screen
Provide a means to repaint the screen if the screen has been corrupted. Provide a means to repaint the screen if the screen has been corrupted.
.It settings .It settings
Show the current values of the operating modes, and right margin. By Show the current values of the operating modes, and right margin.
By
pressing return when the cursor is on a particular item, the value can be pressing return when the cursor is on a particular item, the value can be
changed. To leave this menu, press the changed.
To leave this menu, press the
.Em escape .Em escape
key. (See key.
(See
.Sx Modes .Sx Modes
below.) below.)
.It search .It search
@ -304,7 +318,8 @@ A paragraph may be formatted two ways: explicitly by choosing the
menu item, or by setting menu item, or by setting
.Nm .Nm
to automatically to automatically
format paragraphs. The automatic mode may be set via a menu, or via the format paragraphs.
The automatic mode may be set via a menu, or via the
initialization file. initialization file.
.Pp .Pp
There are three states for text operation in There are three states for text operation in
@ -312,29 +327,34 @@ There are three states for text operation in
free-form, margins, free-form, margins,
and automatic formatting. and automatic formatting.
.Pp .Pp
"Free-form" is best used for things like programming. There are no "Free-form" is best used for things like programming.
There are no
restrictions on the length of lines, and no formatting takes place. restrictions on the length of lines, and no formatting takes place.
.Pp .Pp
"Margins" allows the user to type in text without having to worry about going "Margins" allows the user to type in text without having to worry about going
beyond the right margin (the right margin may be set in the beyond the right margin (the right margin may be set in the
.Em settings .Em settings
menu, the default is for the margin to be the right edge of the menu, the default is for the margin to be the right edge of the
terminal). This is the mode that allows the terminal).
This is the mode that allows the
.Em format paragraph .Em format paragraph
menu item to work. menu item to work.
.Pp .Pp
"Automatic formatting" provides word-processor-like behavior. The user "Automatic formatting" provides word-processor-like behavior.
The user
may type in text, while may type in text, while
.Nm .Nm
will make sure the entire paragraph fits will make sure the entire paragraph fits
within the width of the terminal every time the user inserts a space after within the width of the terminal every time the user inserts a space after
typing or deleting text. Margin observation must also be enabled in order for typing or deleting text.
Margin observation must also be enabled in order for
automatic formatting to occur. automatic formatting to occur.
.Ss Modes .Ss Modes
Although Although
.Nm .Nm
is a 'modeless' editor (it is in text insertion mode all the is a 'modeless' editor (it is in text insertion mode all the
time), there are modes in some of the things it does. These include: time), there are modes in some of the things it does.
These include:
.Bl -tag -width indent .Bl -tag -width indent
.It tab expansion .It tab expansion
Tabs may be inserted as a single tab character, or replaced with spaces. Tabs may be inserted as a single tab character, or replaced with spaces.
@ -348,7 +368,7 @@ While typing in text, the editor can try to keep it looking reasonably well
within the width of the screen. within the width of the screen.
.It eightbit characters .It eightbit characters
Toggle whether eight bit characters are displayed as their value in angle Toggle whether eight bit characters are displayed as their value in angle
brackets (e.g. "<220>") or as a character. brackets (e.g.\& "<220>") or as a character.
.It info window .It info window
A window showing the keyboard operations that can be performed can be A window showing the keyboard operations that can be performed can be
displayed or not. displayed or not.
@ -356,7 +376,8 @@ displayed or not.
Control keys may be given bindings similar to emacs, or not. Control keys may be given bindings similar to emacs, or not.
.It 16 bit characters .It 16 bit characters
Toggles whether sixteen bit characters are handled as one 16-bit quantities or Toggles whether sixteen bit characters are handled as one 16-bit quantities or
two 8-bit quantities. This works primarily with the Chinese Big 5 code set. two 8-bit quantities.
This works primarily with the Chinese Big 5 code set.
.El .El
.Pp .Pp
You may set these modes via the initialization file (see below), or with a You may set these modes via the initialization file (see below), or with a
@ -374,7 +395,8 @@ command.
Using Using
.Nm spell , .Nm spell ,
the words that are not recognized will be placed at the top the words that are not recognized will be placed at the top
of the file. For the of the file.
For the
.Nm ispell .Nm ispell
option, the file is written to disk, option, the file is written to disk,
then then
@ -391,13 +413,15 @@ initialization command
.Em printcommand .Em printcommand
(see the section (see the section
.Sx Initializing ee from a file .Sx Initializing ee from a file
below). The default is to send the contents to below).
The default is to send the contents to
.Xr lp 1 . .Xr lp 1 .
.Pp .Pp
Whatever the user assigns to Whatever the user assigns to
.Em printcommand .Em printcommand
must take input from must take input from
standard input. See your system administrator for more details. standard input.
See your system administrator for more details.
.Ss "Shell operations" .Ss "Shell operations"
Shell commands can be executed from within Shell commands can be executed from within
.Nm .Nm
@ -408,25 +432,31 @@ item in the
menu, or by placing an exclamation mark ("!") before the command to menu, or by placing an exclamation mark ("!") before the command to
execute at the execute at the
.Em command: .Em command:
prompt. Additionally, the user may direct the contents of the edit buffer prompt.
Additionally, the user may direct the contents of the edit buffer
out to a shell operation (via a pipe) by using the left angle bracket out to a shell operation (via a pipe) by using the left angle bracket
(">"), followed by a "!" and the shell command to execute. The output of (">"), followed by a "!" and the shell command to execute.
The output of
a shell operation can also be directed into the edit buffer by using a a shell operation can also be directed into the edit buffer by using a
right angle bracket ("<") before the exclamation mark. These can even be right angle bracket ("<") before the exclamation mark.
These can even be
used together to send output to a shell operation and read back the used together to send output to a shell operation and read back the
results into the editor. So, if the editor contained a list of words results into the editor.
So, if the editor contained a list of words
to be sorted, they could be sorted by typing the following at the command to be sorted, they could be sorted by typing the following at the command
prompt: prompt:
.Dl ><!sort .Dl ><!sort
This would send the contents of the editor to be piped into the This would send the contents of the editor to be piped into the
.Xr sort 1 .Xr sort 1
utility and the result would be placed into the edit buffer at the current utility and the result would be placed into the edit buffer at the current
cursor location. The old information would have to be deleted by the user. cursor location.
The old information would have to be deleted by the user.
.Ss "Initializing ee from a file" .Ss "Initializing ee from a file"
Since different users have different preferences, Since different users have different preferences,
.Nm .Nm
allows some allows some
slight configurability. There are three possible locations for an slight configurability.
There are three possible locations for an
initialization file for initialization file for
.Nm : .Nm :
the file the file
@ -436,7 +466,8 @@ the file
in the user's home directory, or the file in the user's home directory, or the file
.Pa .init.ee .Pa .init.ee
in the current directory (if different from the home in the current directory (if different from the home
directory). This allows system administrators to set some preferences for directory).
This allows system administrators to set some preferences for
the users on a system-wide basis (for example, the the users on a system-wide basis (for example, the
.Em print .Em print
command), command),
@ -518,38 +549,48 @@ the editor (see
.Sx Initializing ee from a file .Sx Initializing ee from a file
above) to a file named above) to a file named
.Pa .init.ee .Pa .init.ee
in the current directory or the user's home directory. If a file named in the current directory or the user's home directory.
If a file named
.Pa .init.ee .Pa .init.ee
already exists, it will be renamed already exists, it will be renamed
.Pa .init.ee.old . .Pa .init.ee.old .
.Sh CAVEATS .Sh CAVEATS
THIS MATERIAL IS PROVIDED "AS IS". THERE ARE THIS MATERIAL IS PROVIDED "AS IS".
THERE ARE
NO WARRANTIES OF ANY KIND WITH REGARD TO THIS NO WARRANTIES OF ANY KIND WITH REGARD TO THIS
MATERIAL, INCLUDING, BUT NOT LIMITED TO, THE MATERIAL, INCLUDING, BUT NOT LIMITED TO, THE
IMPLIED WARRANTIES OF MERCHANTABILITY AND IMPLIED WARRANTIES OF MERCHANTABILITY AND
FITNESS FOR A PARTICULAR PURPOSE. Neither FITNESS FOR A PARTICULAR PURPOSE.
Neither
Hewlett-Packard nor Hugh Mahon shall be liable Hewlett-Packard nor Hugh Mahon shall be liable
for errors contained herein, nor for for errors contained herein, nor for
incidental or consequential damages in incidental or consequential damages in
connection with the furnishing, performance or connection with the furnishing, performance or
use of this material. Neither Hewlett-Packard use of this material.
Neither Hewlett-Packard
nor Hugh Mahon assumes any responsibility for nor Hugh Mahon assumes any responsibility for
the use or reliability of this software or the use or reliability of this software or
documentation. This software and documentation.
documentation is totally UNSUPPORTED. There This software and
is no support contract available. Hewlett-Packard documentation is totally UNSUPPORTED.
There
is no support contract available.
Hewlett-Packard
has done NO Quality Assurance on ANY has done NO Quality Assurance on ANY
of the program or documentation. You may find of the program or documentation.
You may find
the quality of the materials inferior to the quality of the materials inferior to
supported materials. supported materials.
.Pp .Pp
Always make a copy of files that cannot be easily reproduced before Always make a copy of files that cannot be easily reproduced before
editing. Save files early, and save often. editing.
Save files early, and save often.
.Ss "International Code Set Support" .Ss "International Code Set Support"
The The
.Nm .Nm
utility supports single-byte character code sets (eight-bit clean), or the utility supports single-byte character code sets (eight-bit clean), or the
Chinese Big-5 code set. (Other multi-byte code sets may function, but the Chinese Big-5 code set.
(Other multi-byte code sets may function, but the
reason Big-5 works is that a two-byte character also takes up two columns on reason Big-5 works is that a two-byte character also takes up two columns on
the screen.) the screen.)
.Sh WARNINGS .Sh WARNINGS
@ -569,7 +610,8 @@ was developed by
.Pp .Pp
This software and documentation contains This software and documentation contains
proprietary information which is protected by proprietary information which is protected by
copyright. All rights are reserved. copyright.
All rights are reserved.
.Pp .Pp
Copyright (c) 1990, 1991, 1992, 1993, 1995, 1996 Hugh Mahon. Copyright (c) 1990, 1991, 1992, 1993, 1995, 1996 Hugh Mahon.
.Sh "SEE ALSO" .Sh "SEE ALSO"

View File

@ -31,14 +31,17 @@ is a
.Em very .Em very
simple encryption program, working on a simple encryption program, working on a
.Dq secret-key .Dq secret-key
basis. It operates as a filter, i. e. it encrypts or decrypts a basis.
It operates as a filter, i.e.,
it encrypts or decrypts a
stream of data from standard input, and writes the result to standard stream of data from standard input, and writes the result to standard
output. output.
Since its operation is fully symmetrical, feeding the encrypted data Since its operation is fully symmetrical, feeding the encrypted data
stream again through the engine (using the same secret key) will stream again through the engine (using the same secret key) will
decrypt it. decrypt it.
.Pp .Pp
There are several ways to provide the secret key to the program. By There are several ways to provide the secret key to the program.
By
default, the program prompts the user on the controlling terminal for default, the program prompts the user on the controlling terminal for
the key, using the key, using
.Xr getpass 3 . .Xr getpass 3 .
@ -47,7 +50,8 @@ This is the only safe way of providing it.
Alternatively, the key can be provided as the sole command-line Alternatively, the key can be provided as the sole command-line
argument argument
.Ar password .Ar password
when starting the program. Obviously, this way the key can easily be when starting the program.
Obviously, this way the key can easily be
spotted by other users running spotted by other users running
.Xr ps 1 . .Xr ps 1 .
As yet another alternative, As yet another alternative,
@ -73,7 +77,8 @@ little more secure, but incompatible with other implementations.
.Ss Warning .Ss Warning
The cryptographic value of The cryptographic value of
.Nm .Nm
is rather small. This program is only provided here for compatibility is rather small.
This program is only provided here for compatibility
with other operating systems that also provide an implementation with other operating systems that also provide an implementation
(usually called (usually called
.Xr crypt 1 .Xr crypt 1
@ -121,6 +126,7 @@ Implementations of
.Nm crypt .Nm crypt
are very common among are very common among
.Ux .Ux
operating systems. This implementation has been taken from the operating systems.
This implementation has been taken from the
.Em Cryptbreakers Workbench .Em Cryptbreakers Workbench
which is in the public domain. which is in the public domain.

View File

@ -81,7 +81,8 @@ The following options are available:
.Nm ( unexpand .Nm ( unexpand
only.) only.)
By default, only leading blanks and tabs 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 .Fl a
option is given, then tabs are inserted whenever they would compress the option is given, then tabs are inserted whenever they would compress the
resultant file by replacing two or more characters. resultant file by replacing two or more characters.

View File

@ -424,7 +424,9 @@ directory (source for the
file) is too long to include here. file) is too long to include here.
You know who you are; thank you. You know who you are; thank you.
.Sh LEGAL NOTICE .Sh LEGAL NOTICE
Copyright (c) Ian F. Darwin, Toronto, Canada, 1986-1999. Copyright (c)
.An Ian F. Darwin ,
Toronto, Canada, 1986-1999.
Covered by the standard Berkeley Software Distribution copyright; see the file Covered by the standard Berkeley Software Distribution copyright; see the file
.Pa LEGAL.NOTICE .Pa LEGAL.NOTICE
in the source distribution. in the source distribution.

View File

@ -105,15 +105,17 @@ The numeric types may optionally be followed by
.Em & .Em &
and a numeric value, and a numeric value,
to specify that the value is to be AND'ed with the to specify that the value is to be AND'ed with the
numeric value before any comparisons are done. Prepending a numeric value before any comparisons are done.
Prepending a
.Em u .Em u
to the type indicates that ordered comparisons should be unsigned. to the type indicates that ordered comparisons should be unsigned.
.Bl -tag -width indent .Bl -tag -width indent
.It test .It test
The value to be compared with the value from the file. If the type is The value to be compared with the value from the file.
If the type is
numeric, this value numeric, this value
is specified in C form; if it is a string, it is specified as a C string is specified in C form; if it is a string, it is specified as a C string
with the usual escapes permitted (e.g. \en for new-line). with the usual escapes permitted (e.g.\& \en for new-line).
.It "" .It ""
Numeric values Numeric values
may be preceded by a character indicating the operation to be performed. may be preceded by a character indicating the operation to be performed.
@ -157,12 +159,14 @@ and
.Em & ) .Em & )
can be applied to strings. can be applied to strings.
The length used for matching is that of the string argument The length used for matching is that of the string argument
in the magic file. This means that a line can match any string, and in the magic file.
This means that a line can match any string, and
then presumably print that string, by doing then presumably print that string, by doing
.Em >\e0 .Em >\e0
(because all strings are greater than the null string). (because all strings are greater than the null string).
.It message .It message
The message to be printed if the comparison succeeds. If the string The message to be printed if the comparison succeeds.
If the string
contains a contains a
.Xr printf 3 .Xr printf 3
format specification, the value from the file (with any specified masking format specification, the value from the file (with any specified masking
@ -170,9 +174,11 @@ performed) is printed using the message as the format string.
.El .El
.Pp .Pp
Some file formats contain additional information which is to be printed Some file formats contain additional information which is to be printed
along with the file type. A line which begins with the character along with the file type.
A line which begins with the character
.Em > .Em >
indicates additional tests and messages to be printed. The number of indicates additional tests and messages to be printed.
The number of
.Em > .Em >
on the line indicates the level of the test; a line with no on the line indicates the level of the test; a line with no
.Em > .Em >
@ -186,7 +192,8 @@ If the test on a line at level
.Em n .Em n
succeeds, the tests specified in all the subsequent lines at level succeeds, the tests specified in all the subsequent lines at level
.Em n+1 .Em n+1
are performed, and the messages printed if the tests succeed. The next are performed, and the messages printed if the tests succeed.
The next
line at level line at level
.Em n .Em n
terminates this. terminates this.

View File

@ -94,7 +94,8 @@ option, the office location and office phone information is displayed
instead of the name of the remote host. instead of the name of the remote host.
.It Fl g .It Fl g
This option restricts the gecos output to only the users' real This option restricts the gecos output to only the users' real
name. It also has the side-effect of restricting the output name.
It also has the side-effect of restricting the output
of the remote host when used in conjunction with the of the remote host when used in conjunction with the
.Fl h .Fl h
option. option.
@ -247,6 +248,8 @@ command appeared in
.Bx 3.0 . .Bx 3.0 .
.Sh BUGS .Sh BUGS
The current FINGER protocol RFC requires that the client keep the connection The current FINGER protocol RFC requires that the client keep the connection
fully open until the server closes. This prevents the use of the optimal fully open until the server closes.
three-packet T/TCP exchange. (Servers which depend on this requirement are This prevents the use of the optimal
three-packet T/TCP exchange.
(Servers which depend on this requirement are
bogus but have nonetheless been observed in the Internet at large.) bogus but have nonetheless been observed in the Internet at large.)

View File

@ -79,7 +79,8 @@ which is the kernel image the system has booted from.
Include memory-mapped files in the listing; normally these are excluded Include memory-mapped files in the listing; normally these are excluded
due to the extra processing required. due to the extra processing required.
.It Fl n .It Fl n
Numerical format. Print the device number (maj,min) of the file system Numerical format.
Print the device number (maj,min) of the file system
the file resides in rather than the mount point name; for special the file resides in rather than the mount point name; for special
files, print the files, print the
device number that the special device refers to rather than the filename device number that the special device refers to rather than the filename
@ -91,12 +92,15 @@ Report all files open by the specified process.
.It Fl u .It Fl u
Report all files open by the specified user. Report all files open by the specified user.
.It Fl v .It Fl v
Verbose mode. Print error messages upon failures to locate particular Verbose mode.
system data structures rather than silently ignoring them. Most of 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 these data structures are dynamically created or deleted and it is
possible for them to disappear while possible for them to disappear while
.Nm .Nm
is running. This is running.
This
is normal and unavoidable since the rest of the system is running while is normal and unavoidable since the rest of the system is running while
.Nm .Nm
itself is running. itself is running.
@ -145,7 +149,8 @@ major/minor number of the device that this file resides in.
.It Li INUM .It Li INUM
The inode number of the file. The inode number of the file.
.It Li MODE .It Li MODE
The mode of the file. If the The mode of the file.
If the
.Fl n .Fl n
flag isn't specified, the mode is printed flag isn't specified, the mode is printed
using a symbolic format (see using a symbolic format (see
@ -154,7 +159,8 @@ otherwise, the mode is printed
as an octal number. as an octal number.
.It Li SZ\&|DV .It Li SZ\&|DV
If the file is not a character or block special, prints the size of If the file is not a character or block special, prints the size of
the file in bytes. Otherwise, if the the file in bytes.
Otherwise, if the
.Fl n .Fl n
flag is not specified, prints flag is not specified, prints
the name of the special file as located in the name of the special file as located in
@ -177,7 +183,8 @@ flag is not, then
this field is present and is the name associated with the given file. this field is present and is the name associated with the given file.
Normally the name cannot be determined since there is no mapping 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 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 the same file (via
.Xr ln 1 ) , .Xr ln 1 ) ,
the name printed may not be the actual the name printed may not be the actual

View File

@ -68,8 +68,10 @@ Write the core file to the specified file instead of
.Dq Pa core.<pid> . .Dq Pa core.<pid> .
.It Fl s .It Fl s
Stop the process while gathering the core image, and resume it Stop the process while gathering the core image, and resume it
when done. This guarantees that the resulting core dump will when done.
be in a consistent state. The process is resumed even if it was This guarantees that the resulting core dump will
be in a consistent state.
The process is resumed even if it was
already stopped. already stopped.
The same effect can be achieved manually with The same effect can be achieved manually with
.Xr kill 1 . .Xr kill 1 .

View File

@ -45,7 +45,8 @@ into a formatted message catalog file
.Ar "output-file" . .Ar "output-file" .
The file The file
.Ar "output-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" .Ar "output-file"
does exist, its messages will be included in the new does exist, its messages will be included in the new
.Ar "output-file" . .Ar "output-file" .
@ -54,7 +55,8 @@ If set and message numbers collide, the new message text defined in
will replace the old message text currently contained in will replace the old message text currently contained in
.Ar "output-file" . .Ar "output-file" .
.Sh INPUT FILES .Sh INPUT FILES
The format of a message text source file is defined below. Note that 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 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 character: any other space characters are considered to be part of the
field contents. field contents.
@ -64,21 +66,27 @@ field contents.
This line specifies the set identifier of the following messages until This line specifies the set identifier of the following messages until
the next the next
.Li $set .Li $set
or end-of-file appears. The argument or end-of-file appears.
The argument
.Ar n .Ar n
is the set identifier which is defined as a number in the range is the set identifier which is defined as a number in the range
[1, (NL_SETMAX)]. Set identifiers must occur in ascending order within [1, (NL_SETMAX)].
a single source file, but need not be contiguous. Any string following Set identifiers must occur in ascending order within
a space following the set identifier is treated as a comment. If no 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 .Li $set
directive is specified in a given source file, all messages will directive is specified in a given source file, all messages will
be located in the default message set NL_SETD. be located in the default message set NL_SETD.
.It Li $del Ar n comment .It Li $del Ar n comment
This line deletes messages from set This line deletes messages from set
.Ar n .Ar n
from a message catalog. The from a message catalog.
The
.Ar n .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. number is treated as a comment.
.It Li $ Ar comment .It Li $ Ar comment
A line beginning with A line beginning with
@ -87,7 +95,8 @@ followed by a space is treated as a comment.
.It Ar m message-text .It Ar m message-text
A message line consists of a message identifier A message line consists of a message identifier
.Ar m .Ar m
in the range [1, (NL_MSGMAX)]. The in the range [1, (NL_MSGMAX)].
The
.Ar message-text .Ar message-text
is stored in the message catalog with the set identifier specified by is stored in the message catalog with the set identifier specified by
the last the last
@ -97,13 +106,16 @@ directive, and the message identifier
If the If the
.Ar message-text .Ar message-text
is empty, and there is a space character following the message identifier, 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 .Ar message-text
is empty, and if there is no space character following the message is empty, and if there is no space character following the message
identifier, then the existing message in the current set with the identifier, then the existing message in the current set with the
specified message identifier is deleted from the catalog. Message specified message identifier is deleted from the catalog.
Message
identifiers must be in ascending order within a single set, but identifiers must be in ascending order within a single set, but
need not be contiguous. The need not be contiguous.
The
.Ar message-text .Ar message-text
length must be in the range [0, (NL_TEXTMAX)]. length must be in the range [0, (NL_TEXTMAX)].
.It Li $quote Ar c .It Li $quote Ar c
@ -112,19 +124,22 @@ This line specifies an optional quote character
which can be used to surround which can be used to surround
.Ar message-text .Ar message-text
so that trailing space or empty messages are visible in message 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 .Li $quote
directive is specified, no quoting of directive is specified, no quoting of
.Ar message-text .Ar message-text
will be recognized. will be recognized.
.El .El
.Pp .Pp
Empty lines in message source files are ignored. The effect of lines Empty lines in message source files are ignored.
The effect of lines
beginning with any character other than those described above is beginning with any character other than those described above is
undefined. undefined.
.Pp .Pp
Text strings can contain the following special characters and escape 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. escaped as well to embed a literal quote character.
.Pp .Pp
.Bl -tag -width "\eooo" -offset indent -compact .Bl -tag -width "\eooo" -offset indent -compact

View File

@ -109,7 +109,8 @@ has.
.Pp .Pp
Arguments containing white space or embedded shell metacharacters Arguments containing white space or embedded shell metacharacters
generally will not survive intact; this looks easy to fix but generally will not survive intact; this looks easy to fix but
isn't. People trying to fix isn't.
People trying to fix
.Nm .Nm
or the example in this manpage should check the history of this file or the example in this manpage should check the history of this file
in in
@ -129,6 +130,7 @@ command to set the arguments without disrupting the value(s) of
shell options varies from one shell version to another. shell options varies from one shell version to another.
.Pp .Pp
Each shellscript has to carry complex code to parse arguments halfway Each shellscript has to carry complex code to parse arguments halfway
correctly (like the example presented here). A better getopt-like tool correctly (like the example presented here).
A better getopt-like tool
would move much of the complexity into the tool and keep the client would move much of the complexity into the tool and keep the client
shell scripts simpler. shell scripts simpler.

View File

@ -67,7 +67,7 @@ option also links in versions of the library routines
that are compiled for profiling. that are compiled for profiling.
By convention these libraries have their name suffixed with By convention these libraries have their name suffixed with
.Pa _p , .Pa _p ,
i.e. the profiled version of i.e., the profiled version of
.Pa libc.a .Pa libc.a
is is
.Pa libc_p.a .Pa libc_p.a
@ -237,10 +237,12 @@ to accumulate profile data across several runs of an
file. file.
.It Fl u .It Fl u
Suppress the printing of functions whose names are not visible to Suppress the printing of functions whose names are not visible to
C programs. For the ELF object format, this means names that C programs.
For the ELF object format, this means names that
contain the contain the
.Ql .\& .Ql .\&
character. For the a.out object format, it means names that do not character.
For the a.out object format, it means names that do not
begin with a begin with a
.Ql _ .Ql _
character. character.

View File

@ -58,7 +58,7 @@ database.
.Bl -tag -width indent .Bl -tag -width indent
.It Aq Ar username .It Aq Ar username
the 8\-character\-or\-less string used to identify users or classes the 8\-character\-or\-less string used to identify users or classes
(e.g. joeuser, root, 1.00, etc). (e.g.\& joeuser, root, 1.00, etc).
Used with the Used with the
.Ar Hesiod_Name_Types .Ar Hesiod_Name_Types
.Cm passwd , .Cm passwd ,
@ -84,9 +84,9 @@ the name of an
.Tn NFS .Tn NFS
server and its partition separated by a colon. server and its partition separated by a colon.
.It Aq Ar workstation\-name .It Aq Ar workstation\-name
the machine name of an Athena workstation (e.g. E40\-343\-3). the machine name of an Athena workstation (e.g.\& E40\-343\-3).
.It Aq Ar service\-name .It Aq Ar service\-name
name of an Athena service (e.g. Zephyr). name of an Athena service (e.g.\& Zephyr).
.It Aq Ar service\-type .It Aq Ar service\-type
name of name of
.Ux .Ux

View File

@ -310,7 +310,7 @@ If, as a result of the specification of the
.Fl n .Fl n
option or end-of-file being reached, input data only partially option or end-of-file being reached, input data only partially
satisfies a format string, the input block is zero-padded sufficiently satisfies a format string, the input block is zero-padded sufficiently
to display all available data (i.e. any format units overlapping the to display all available data (i.e., any format units overlapping the
end of data will display some number of the zero bytes). end of data will display some number of the zero bytes).
.Pp .Pp
Further output by such format strings is replaced by an equivalent Further output by such format strings is replaced by an equivalent

View File

@ -88,12 +88,15 @@ The
.Nm .Nm
utility is a utility is a
.Em C .Em C
program formatter. It reformats the program formatter.
It reformats the
.Em C .Em C
program in the program in the
.Ar input-file .Ar input-file
according to the switches. The switches which can be according to the switches.
specified are described below. They may appear before or after the file The switches which can be
specified are described below.
They may appear before or after the file
names. names.
.Pp .Pp
.Sy NOTE : .Sy NOTE :
@ -104,7 +107,8 @@ done `in-place', that is, the formatted file is written back into
.Ar input-file .Ar input-file
and a backup copy of and a backup copy of
.Ar input-file .Ar input-file
is written in the current directory. If is written in the current directory.
If
.Ar input-file .Ar input-file
is named is named
.Sq Pa /blah/blah/file , .Sq Pa /blah/blah/file ,
@ -125,24 +129,28 @@ The options listed below control the formatting style imposed by
If If
.Fl bad .Fl bad
is specified, a blank line is forced after every block of is specified, a blank line is forced after every block of
declarations. Default: declarations.
Default:
.Fl nbad . .Fl nbad .
.It Fl bap , nbap .It Fl bap , nbap
If If
.Fl bap .Fl bap
is specified, a blank line is forced after every procedure body. Default: is specified, a blank line is forced after every procedure body.
Default:
.Fl nbap . .Fl nbap .
.It Fl bbb , nbbb .It Fl bbb , nbbb
If If
.Fl bbb .Fl bbb
is specified, a blank line is forced before every block comment. Default: is specified, a blank line is forced before every block comment.
Default:
.Fl nbbb . .Fl nbbb .
.It Fl \&bc , nbc .It Fl \&bc , nbc
If If
.Fl \&bc .Fl \&bc
is specified, then a newline is forced after each comma in a declaration. is specified, then a newline is forced after each comma in a declaration.
.Fl nbc .Fl nbc
turns off this option. Default: turns off this option.
Default:
.Fl \&nbc . .Fl \&nbc .
.It Fl \&br , \&bl .It Fl \&br , \&bl
Specifying Specifying
@ -165,12 +173,15 @@ if (...) {
.Ed .Ed
.Pp .Pp
.It Fl c Ns Ar n .It Fl c Ns Ar n
The column in which comments on code start. The default is 33. The column in which comments on code start.
The default is 33.
.It Fl cd Ns Ar n .It Fl cd Ns Ar n
The column in which comments on declarations start. The default The column in which comments on declarations start.
The default
is for these comments to start in the same column as those on code. is for these comments to start in the same column as those on code.
.It Fl cdb , ncdb .It Fl cdb , ncdb
Enables (disables) the placement of comment delimiters on blank lines. With Enables (disables) the placement of comment delimiters on blank lines.
With
this option enabled, comments look like this: this option enabled, comments look like this:
.Bd -literal -offset indent .Bd -literal -offset indent
/* /*
@ -184,18 +195,21 @@ Rather than like this:
.Ed .Ed
.Pp .Pp
This only affects block comments, not comments to the right of This only affects block comments, not comments to the right of
code. The default is code.
The default is
.Fl cdb . .Fl cdb .
.It Fl ce , nce .It Fl ce , nce
Enables (disables) forcing of `else's to cuddle up to the immediately preceding Enables (disables) forcing of `else's to cuddle up to the immediately preceding
`}'. The default is `}'.
The default is
.Fl \&ce . .Fl \&ce .
.It Fl \&ci Ns Ar n .It Fl \&ci Ns Ar n
Sets the continuation indent to be Sets the continuation indent to be
.Ar n . .Ar n .
Continuation Continuation
lines will be indented that far from the beginning of the first line of the lines will be indented that far from the beginning of the first line of the
statement. Parenthesized expressions have extra indentation added to statement.
Parenthesized expressions have extra indentation added to
indicate the nesting, unless indicate the nesting, unless
.Fl \&lp .Fl \&lp
is in effect is in effect
@ -210,17 +224,21 @@ tab stops to the right of the containing
.Ic switch .Ic switch
statement. statement.
.Fl cli0.5 .Fl cli0.5
causes case labels to be indented half a tab stop. The causes case labels to be indented half a tab stop.
The
default is default is
.Fl cli0 . .Fl cli0 .
.It Fl d Ns Ar n .It Fl d Ns Ar n
Controls the placement of comments which are not to the Controls the placement of comments which are not to the
right of code. For example, right of code.
For example,
.Fl \&d\&1 .Fl \&d\&1
means that such comments are placed one indentation level to the means that such comments are placed one indentation level to the
left of code. Specifying the default left of code.
Specifying the default
.Fl \&d\&0 .Fl \&d\&0
lines-up these comments with the code. See the section on comment lines-up these comments with the code.
See the section on comment
indentation below. indentation below.
.It Fl \&di Ns Ar n .It Fl \&di Ns Ar n
Specifies the indentation, in character positions, Specifies the indentation, in character positions,
@ -232,18 +250,21 @@ The default is
.Fl \&dj .Fl \&dj
left justifies declarations. left justifies declarations.
.Fl ndj .Fl ndj
indents declarations the same as code. The default is indents declarations the same as code.
The default is
.Fl ndj . .Fl ndj .
.It Fl \&ei , nei .It Fl \&ei , nei
Enables (disables) special Enables (disables) special
.Ic else-if .Ic else-if
processing. If it's enabled, an processing.
If it's enabled, an
.Ic if .Ic if
following an following an
.Ic else .Ic else
will have the same indentation as the preceding will have the same indentation as the preceding
.Ic \&if .Ic \&if
statement. The default is statement.
The default is
.Fl ei . .Fl ei .
.It Fl fbs , nfbs .It Fl fbs , nfbs
Enables (disables) splitting the function declaration and opening brace Enables (disables) splitting the function declaration and opening brace
@ -253,10 +274,12 @@ The default is
.It Fl fc1 , nfc1 .It Fl fc1 , nfc1
Enables (disables) the formatting of comments that start in column 1. Enables (disables) the formatting of comments that start in column 1.
Often, comments whose leading `/' is in column 1 have been carefully Often, comments whose leading `/' is in column 1 have been carefully
hand formatted by the programmer. In such cases, hand formatted by the programmer.
In such cases,
.Fl nfc1 .Fl nfc1
should be should be
used. The default is used.
The default is
.Fl fc1 . .Fl fc1 .
.It Fl fcb , nfcb .It Fl fcb , nfcb
Enables (disables) the formatting of block comments (ones that begin Enables (disables) the formatting of block comments (ones that begin
@ -271,13 +294,16 @@ Block comments are then handled like box comments.
The default is The default is
.Fl fcb . .Fl fcb .
.It Fl i Ns Ar n .It Fl i Ns Ar n
The number of spaces for one indentation level. The default is 8. The number of spaces for one indentation level.
The default is 8.
.It Fl \&ip , nip .It Fl \&ip , nip
Enables (disables) the indentation of parameter declarations from the left Enables (disables) the indentation of parameter declarations from the left
margin. The default is margin.
The default is
.Fl \&ip . .Fl \&ip .
.It Fl l Ns Ar n .It Fl l Ns Ar n
Maximum length of an output line. The default is 78. Maximum length of an output line.
The default is 78.
.It Fl \&ldi Ns Ar n .It Fl \&ldi Ns Ar n
Specifies the indentation, in character positions, Specifies the indentation, in character positions,
of local variable names of local variable names
@ -285,10 +311,12 @@ relative to the beginning of their type declaration.
The default is for local variable names to be indented The default is for local variable names to be indented
by the same amount as global ones. by the same amount as global ones.
.It Fl \&lp , nlp .It Fl \&lp , nlp
Lines-up code surrounded by parenthesis in continuation lines. If a line Lines-up code surrounded by parenthesis in continuation lines.
If a line
has a left paren which is not closed on that line, then continuation lines has a left paren which is not closed on that line, then continuation lines
will be lined up to start at the character position just after the left will be lined up to start at the character position just after the left
paren. For example, here is how a piece of continued code looks with paren.
For example, here is how a piece of continued code looks with
.Fl nlp .Fl nlp
in effect: in effect:
.Bd -literal -offset indent .Bd -literal -offset indent
@ -321,24 +349,29 @@ to be ignored.
If true If true
.Pq Fl pcs .Pq Fl pcs
all procedure calls will have a space inserted between all procedure calls will have a space inserted between
the name and the `('. The default is the name and the `('.
The default is
.Fl npcs . .Fl npcs .
.It Fl psl , npsl .It Fl psl , npsl
If true If true
.Pq Fl psl .Pq Fl psl
the names of procedures being defined are placed in the names of procedures being defined are placed in
column 1 \- their types, if any, will be left on the previous lines. The column 1 \- their types, if any, will be left on the previous lines.
The
default is default is
.Fl psl . .Fl psl .
.It Fl \&sc , nsc .It Fl \&sc , nsc
Enables (disables) the placement of asterisks (`*'s) at the left edge of all Enables (disables) the placement of asterisks (`*'s) at the left edge of all
comments. The default is comments.
The default is
.Fl sc . .Fl sc .
.It Fl sob , nsob .It Fl sob , nsob
If If
.Fl sob .Fl sob
is specified, indent will swallow optional blank lines. You can use this to is specified, indent will swallow optional blank lines.
get rid of blank lines after declarations. Default: You can use this to
get rid of blank lines after declarations.
Default:
.Fl nsob . .Fl nsob .
.It Fl \&st .It Fl \&st
Causes Causes
@ -347,14 +380,17 @@ to take its input from stdin and put its output to stdout.
.It Fl T Ns Ar typename .It Fl T Ns Ar typename
Adds Adds
.Ar typename .Ar typename
to the list of type keywords. Names accumulate: to the list of type keywords.
Names accumulate:
.Fl T .Fl T
can be specified more than once. You need to specify all the typenames that can be specified more than once.
You need to specify all the typenames that
appear in your program that are defined by appear in your program that are defined by
.Ic typedef .Ic typedef
\- nothing will be \- nothing will be
harmed if you miss a few, but the program won't be formatted as nicely as harmed if you miss a few, but the program won't be formatted as nicely as
it should. This sounds like a painful thing to have to do, but it's really it should.
This sounds like a painful thing to have to do, but it's really
a symptom of a problem in C: a symptom of a problem in C:
.Ic typedef .Ic typedef
causes a syntactic change in the causes a syntactic change in the
@ -382,10 +418,12 @@ The default is
.Fl v .Fl v
turns on `verbose' mode; turns on `verbose' mode;
.Fl \&nv .Fl \&nv
turns it off. When in verbose mode, turns it off.
When in verbose mode,
.Nm .Nm
reports when it splits one line of input into two or more lines of output, reports when it splits one line of input into two or more lines of output,
and gives some size statistics at completion. The default is and gives some size statistics at completion.
The default is
.Fl \&nv . .Fl \&nv .
.El .El
.Pp .Pp
@ -394,12 +432,16 @@ You may set up your own `profile' of defaults to
by creating a file called by creating a file called
.Pa .indent.pro .Pa .indent.pro
in your login directory and/or the current directory and including in your login directory and/or the current directory and including
whatever switches you like. A `.indent.pro' in the current directory takes whatever switches you like.
precedence over the one in your login directory. If A `.indent.pro' in the current directory takes
precedence over the one in your login directory.
If
.Nm .Nm
is run and a profile file exists, then it is read to set up the program's is run and a profile file exists, then it is read to set up the program's
defaults. Switches on the command line, though, always override profile defaults.
switches. The switches should be separated by spaces, tabs or newlines. Switches on the command line, though, always override profile
switches.
The switches should be separated by spaces, tabs or newlines.
.Pp .Pp
.Ss Comments .Ss Comments
.Sq Em Box .Sq Em Box
@ -418,28 +460,34 @@ All other comments are treated as straight text.
The The
.Nm .Nm
utility fits as many words (separated by blanks, tabs, or newlines) on a utility fits as many words (separated by blanks, tabs, or newlines) on a
line as possible. Blank lines break paragraphs. line as possible.
Blank lines break paragraphs.
.Pp .Pp
.Ss Comment indentation .Ss Comment indentation
If a comment is on a line with code it is started in the `comment column', If a comment is on a line with code it is started in the `comment column',
which is set by the which is set by the
.Fl c Ns Ns Ar n .Fl c Ns Ns Ar n
command line parameter. Otherwise, the comment is started at command line parameter.
Otherwise, the comment is started at
.Ar n .Ar n
indentation levels less than where code is currently being placed, where indentation levels less than where code is currently being placed, where
.Ar n .Ar n
is specified by the is specified by the
.Fl d Ns Ns Ar n .Fl d Ns Ns Ar n
command line parameter. If the code on a line extends past the comment command line parameter.
If the code on a line extends past the comment
column, the comment starts further to the right, and the right margin may be column, the comment starts further to the right, and the right margin may be
automatically extended in extreme cases. automatically extended in extreme cases.
.Pp .Pp
.Ss Preprocessor lines .Ss Preprocessor lines
In general, In general,
.Nm .Nm
leaves preprocessor lines alone. The only leaves preprocessor lines alone.
reformatting that it will do is to straighten up trailing comments. It The only
leaves embedded comments alone. Conditional compilation reformatting that it will do is to straighten up trailing comments.
It
leaves embedded comments alone.
Conditional compilation
.Pq Ic #ifdef...#endif .Pq Ic #ifdef...#endif
is recognized and is recognized and
.Nm .Nm
@ -450,8 +498,10 @@ compensate for the syntactic peculiarities introduced.
The The
.Nm .Nm
utility understands a substantial amount about the syntax of C, but it utility understands a substantial amount about the syntax of C, but it
has a `forgiving' parser. It attempts to cope with the usual sorts of has a `forgiving' parser.
incomplete and misformed syntax. In particular, the use of macros like: It attempts to cope with the usual sorts of
incomplete and misformed syntax.
In particular, the use of macros like:
.Pp .Pp
.Dl #define forever for(;;) .Dl #define forever for(;;)
.Pp .Pp

View File

@ -42,7 +42,8 @@
The The
.Nm .Nm
utility removes the specified message queues, semaphores and shared memory utility removes the specified message queues, semaphores and shared memory
segments. These System V IPC objects can be specified by their segments.
These System V IPC objects can be specified by their
creation id or any associated key. creation id or any associated key.
.Pp .Pp
The following options are used to specify which IPC objects will be removed. The following options are used to specify which IPC objects will be removed.

View File

@ -63,7 +63,8 @@ and
options.) options.)
.It Fl b .It Fl b
Show the maximum allowed sizes for active semaphores, message queues, Show the maximum allowed sizes for active semaphores, message queues,
and shared memory segments. The and shared memory segments.
The
.Dq maximum allowed size .Dq maximum allowed size
is the maximum number of bytes in a message on a message queue, is the maximum number of bytes in a message on a message queue,
the size of a shared memory segment, the size of a shared memory segment,
@ -75,13 +76,15 @@ and shared memory segments.
Display information about active shared memory segments. Display information about active shared memory segments.
.It Fl o .It Fl o
Show outstanding usage for active message queues, Show outstanding usage for active message queues,
and shared memory segments. The and shared memory segments.
The
.Dq outstanding usage .Dq outstanding usage
is the number of messages in a message queue, or the number is the number of messages in a message queue, or the number
of processes attached to a shared memory segment. of processes attached to a shared memory segment.
.It Fl p .It Fl p
Show the process ID information for active semaphores, message queues, Show the process ID information for active semaphores, message queues,
and shared memory segments. The and shared memory segments.
The
.Dq process ID information .Dq process ID information
is the last process to send a message to or receive a message from is the last process to send a message to or receive a message from
a message queue, a message queue,
@ -93,7 +96,8 @@ Display information about active message queues.
Display information about active semaphores. Display information about active semaphores.
.It Fl t .It Fl t
Show access times for active semaphores, message queues, Show access times for active semaphores, message queues,
and shared memory segments. The access times is the time and shared memory segments.
The access times is the time
of the last control operation on an IPC object, of the last control operation on an IPC object,
the last send or receive of a message, the last send or receive of a message,
the last attach or detach of a shared memory segment, the last attach or detach of a shared memory segment,

View File

@ -82,7 +82,7 @@ and leading tabs and spaces are ignored.
The default output field separator is a single space character. The default output field separator is a single space character.
.Pp .Pp
Many of the options use file and field numbers. Many of the options use file and field numbers.
Both file numbers and field numbers are 1 based, i.e. the first file on Both file numbers and field numbers are 1 based, i.e., the first file on
the command line is file number 1 and the first field is field number 1. the command line is file number 1 and the first field is field number 1.
The following options are available: The following options are available:
.Bl -tag -width indent .Bl -tag -width indent
@ -218,7 +218,6 @@ command conforms to
.Xr sort 1 , .Xr sort 1 ,
.Xr uniq 1 .Xr uniq 1
.Sh BUGS .Sh BUGS
.Pp
The The
.Nm .Nm
utility does not recognize multibyte characters. utility does not recognize multibyte characters.

View File

@ -168,11 +168,11 @@ may be obtained through
.Pp .Pp
and thirty and thirty
.Xr ed 1 .Xr ed 1
substitution commands applying to lines 2, 7, 12, etc. is substitution commands applying to lines 2, 7, 12, etc.\& is
the result of the result of
.Dl jot -w %ds/old/new/ 30 2 - 5 .Dl jot -w %ds/old/new/ 30 2 - 5
.Pp .Pp
The stuttering sequence 9, 9, 8, 8, 7, etc. can be The stuttering sequence 9, 9, 8, 8, 7, etc.\& can be
produced by suitable choice of step size, produced by suitable choice of step size,
as in as in
.Dl jot - 9 0 -.5 .Dl jot - 9 0 -.5

View File

@ -58,7 +58,8 @@ The super-user is allowed to kill any process.
The options are as follows: The options are as follows:
.Bl -tag -width 10n -offset indent .Bl -tag -width 10n -offset indent
.It Fl d | v .It Fl d | v
Be more verbose about what will be done. For a single Be more verbose about what will be done.
For a single
.Fl d .Fl d
option, a list of the processes that will be sent the signal will be option, a list of the processes that will be sent the signal will be
printed, or a message indicating that no matching processes have been printed, or a message indicating that no matching processes have been
@ -78,7 +79,8 @@ Match the argument
.Ar procname .Ar procname
as a (case sensitive) regular expression against the names as a (case sensitive) regular expression against the names
of processes found. of processes found.
CAUTION! This is dangerous, a single dot will match any process CAUTION!
This is dangerous, a single dot will match any process
running under the real UID of the caller. running under the real UID of the caller.
.It Fl s .It Fl s
Show only what would be done, but do not send any signal. Show only what would be done, but do not send any signal.
@ -120,15 +122,17 @@ is already supported by
.Xr kill 1 . .Xr kill 1 .
So use So use
.Xr kill 1 .Xr kill 1
for this job (e.g. $ kill -TERM -1 or for this job (e.g.\& $ kill -TERM -1 or
as root $ echo kill -TERM -1 | su -m <user>) as root $ echo kill -TERM -1 | su -m <user>)
.Sh DIAGNOSTICS .Sh DIAGNOSTICS
The The
.Nm .Nm
command will respond with a short usage message and exit with a status command will respond with a short usage message and exit with a status
of 2 in case of a command error. A status of 1 will be returned if of 2 in case of a command error.
A status of 1 will be returned if
either no matching process has been found or not all processes have either no matching process has been found or not all processes have
been signalled successfully. Otherwise, a status of 0 will be been signalled successfully.
Otherwise, a status of 0 will be
returned. returned.
.Pp .Pp
Diagnostic messages will only be printed if requested by Diagnostic messages will only be printed if requested by

View File

@ -90,7 +90,7 @@ format, suitable for the calling shell.
The calling shell is determined by examining the entries in the The calling shell is determined by examining the entries in the
.Pa /proc .Pa /proc
file system for the parent process. file system for the parent process.
If the shell is known (i.e. it is one of If the shell is known (i.e., it is one of
.Nm sh , csh , bash , tcsh , ksh , pdksh .Nm sh , csh , bash , tcsh , ksh , pdksh
or or
.Nm rc ) , .Nm rc ) ,
@ -346,7 +346,7 @@ The
utility utility
exits with exits with
.Dv EXIT_FAILURE .Dv EXIT_FAILURE
if usage is incorrect in any way; i.e. an invalid if usage is incorrect in any way; i.e., an invalid
option, or set/display options are selected in the same invocation, option, or set/display options are selected in the same invocation,
.Fl e .Fl e
is used when running a program, etc. is used when running a program, etc.

View File

@ -77,7 +77,8 @@ As a special case, a pattern containing no globbing characters
is matched as though it were is matched as though it were
.Dq *foo* . .Dq *foo* .
.Pp .Pp
Historically, locate only stored characters between 32 and 127. The Historically, locate only stored characters between 32 and 127.
The
current implementation store any character except newline current implementation store any character except newline
.Pq Sq \en .Pq Sq \en
and NUL and NUL
@ -99,7 +100,8 @@ Search in
instead the default file name database. instead the default file name database.
Multiple Multiple
.Fl d .Fl d
options are allowed. Each additional options are allowed.
Each additional
.Fl d .Fl d
option adds the specified database to the list option adds the specified database to the list
of databases to be searched. of databases to be searched.
@ -155,7 +157,8 @@ $ zcat database.gz | locate -d - pattern
.Ed .Ed
.Pp .Pp
This might be useful on machines with a fast CPU and little RAM and slow This might be useful on machines with a fast CPU and little RAM and slow
I/O. Note: you can only use I/O.
Note: you can only use
.Ar one .Ar one
pattern for stdin. pattern for stdin.
.It Fl i .It Fl i
@ -212,11 +215,13 @@ option was specified.
The The
.Nm .Nm
program may fail to list some files that are present, or may program may fail to list some files that are present, or may
list files that have been removed from the system. This is because list files that have been removed from the system.
This is because
locate only reports files that are present in the database, which is locate only reports files that are present in the database, which is
typically only regenerated once a week by the typically only regenerated once a week by the
.Pa /etc/periodic/weekly/310.locate .Pa /etc/periodic/weekly/310.locate
script. Use script.
Use
.Xr find 1 .Xr find 1
to locate files that are of a more transitory nature. to locate files that are of a more transitory nature.
.Pp .Pp
@ -233,7 +238,7 @@ group
.Dq nobody , .Dq nobody ,
or or
world. world.
E.g. if your HOME directory is not world-readable, all your E.g.\& if your HOME directory is not world-readable, all your
files are files are
.Ar not .Ar not
in the database. in the database.

View File

@ -55,7 +55,8 @@ with the appropriate permission.
The following options are available: The following options are available:
.Bl -tag -width indent .Bl -tag -width indent
.It Fl n .It Fl n
Don't use a timeout value. Terminal will be locked forever. Don't use a timeout value.
Terminal will be locked forever.
.It Fl p .It Fl p
A password is not requested, instead the user's current login password A password is not requested, instead the user's current login password
is used. is used.

View File

@ -74,14 +74,16 @@ Causes
to operate silently. to operate silently.
Failure to acquire the lock is indicated only in the exit status. Failure to acquire the lock is indicated only in the exit status.
.It Fl t Ar seconds .It Fl t Ar seconds
Specifies a timeout for waiting for the lock. By default, Specifies a timeout for waiting for the lock.
By default,
.Nm .Nm
waits indefinitely to acquire the lock. waits indefinitely to acquire the lock.
If a timeout is specified with this option, If a timeout is specified with this option,
.Nm .Nm
will wait at most the given number of will wait at most the given number of
.Ar seconds .Ar seconds
before giving up. A timeout of 0 may be given, in which case before giving up.
A timeout of 0 may be given, in which case
.Nm .Nm
will fail unless it can acquire the lock immediately. will fail unless it can acquire the lock immediately.
.El .El

View File

@ -17,7 +17,8 @@ When someone logs in, the
.Nm .Nm
is scanned for the first entry that is scanned for the first entry that
matches the (user, host) combination, or, in case of non-networked matches the (user, host) combination, or, in case of non-networked
logins, the first entry that matches the (user, tty) combination. The logins, the first entry that matches the (user, tty) combination.
The
permissions field of that table entry determines whether the login will permissions field of that table entry determines whether the login will
be accepted or refused. be accepted or refused.
.Pp .Pp
@ -29,11 +30,13 @@ character:
The first field should be a "+" (access granted) or "-" (access denied) The first field should be a "+" (access granted) or "-" (access denied)
character. character.
The second field should be a list of one or more login names, The second field should be a list of one or more login names,
group names, or ALL (always matches). The third field should be a list group names, or ALL (always matches).
The third field should be a list
of one or more tty names (for non-networked logins), host names, domain of one or more tty names (for non-networked logins), host names, domain
names (begin with "."), host addresses, internet network numbers (end names (begin with "."), host addresses, internet network numbers (end
with "."), ALL (always matches) or LOCAL (matches any string that does with "."), ALL (always matches) or LOCAL (matches any string that does
not contain a "." character). If you run NIS you can use @netgroupname not contain a "." character).
If you run NIS you can use @netgroupname
in host or user patterns. in host or user patterns.
.Pp .Pp
The EXCEPT operator makes it possible to write very compact rules. The EXCEPT operator makes it possible to write very compact rules.

View File

@ -68,12 +68,12 @@ alphabetic characters is ignored.
The following options are available: The following options are available:
.Bl -tag -width indent .Bl -tag -width indent
.It Fl d .It Fl d
Dictionary character set and order, i.e. only alphanumeric characters Dictionary character set and order, i.e., only alphanumeric characters
are compared. are compared.
.It Fl f .It Fl f
Ignore the case of alphabetic characters. Ignore the case of alphabetic characters.
.It Fl t .It Fl t
Specify a string termination character, i.e. only the characters Specify a string termination character, i.e., only the characters
in in
.Ar string .Ar string
up to and including the first occurrence of up to and including the first occurrence of

View File

@ -15,11 +15,13 @@
The The
.Nm .Nm
command lists information about the currently loaded virtual file system command lists information about the currently loaded virtual file system
modules. When modules.
When
.Ar vfsname .Ar vfsname
arguments are given, arguments are given,
.Nm .Nm
lists information about the specified VFS modules. Otherwise, lists information about the specified VFS modules.
Otherwise,
.Nm .Nm
lists all currently loaded modules. lists all currently loaded modules.
The information is as follows: The information is as follows:

View File

@ -248,7 +248,7 @@ argument is not found,
returns \-1. returns \-1.
.It Ic indir .It Ic indir
Indirectly calls the macro whose name is passed as the first arguments, Indirectly calls the macro whose name is passed as the first arguments,
with the remaining arguments passed as first, etc. arguments. with the remaining arguments passed as first, etc.\& arguments.
.It Ic len .It Ic len
Returns the number of characters in the first argument. Returns the number of characters in the first argument.
Extra arguments Extra arguments

View File

@ -347,7 +347,7 @@ Append the value to the current value of the variable.
.It Ic \&?= .It Ic \&?=
Assign the value to the variable if it is not already defined. Assign the value to the variable if it is not already defined.
.It Ic \&:= .It Ic \&:=
Assign with expansion, i.e. expand the value before assigning it Assign with expansion, i.e., expand the value before assigning it
to the variable. to the variable.
Normally, expansion is not done until the variable is referenced. Normally, expansion is not done until the variable is referenced.
.It Ic \&!= .It Ic \&!=
@ -1058,7 +1058,7 @@ Loops are not being
detected and targets that form loops will be silently ignored. detected and targets that form loops will be silently ignored.
.El .El
.Sh "SPECIAL TARGETS" .Sh "SPECIAL TARGETS"
Special targets may not be included with other targets, i.e. they must be Special targets may not be included with other targets, i.e., they must be
the only target specified. the only target specified.
.Bl -tag -width Ic .Bl -tag -width Ic
.It Ic .BEGIN .It Ic .BEGIN

View File

@ -44,7 +44,8 @@ utility starts
only for file systems physically mounted on the system only for file systems physically mounted on the system
where the where the
.Nm .Nm
is being executed. Running makewhatis is being executed.
Running makewhatis
by by
.Pa periodic weekly .Pa periodic weekly
for rw nfs-mounted /usr may kill for rw nfs-mounted /usr may kill

View File

@ -39,7 +39,8 @@ The
.Nm .Nm
utility is a minimal implementation of the utility is a minimal implementation of the
.Xr gzip 1 .Xr gzip 1
utility. It supports utility.
It supports
compression and decompression of individual files, as well as compression and decompression of individual files, as well as
streaming compression and decompression via standard input and streaming compression and decompression via standard input and
output. output.
@ -52,9 +53,11 @@ flag on the commandline.
If any If any
.Ar file .Ar file
arguments are supplied, the operation is performed on each file arguments are supplied, the operation is performed on each file
separately. Compression replaces the original file with one having a separately.
Compression replaces the original file with one having a
.Pa .gz .Pa .gz
suffix. Decompression will remove a suffix.
Decompression will remove a
.Pa .gz .Pa .gz
suffix if one is present. suffix if one is present.
.Pp .Pp

View File

@ -63,7 +63,8 @@ where the macro SRCS is the list of C source files and the macro
CFLAGS is the list of flags for the C compiler. CFLAGS is the list of flags for the C compiler.
.Pp .Pp
The user has the ability to change the preprocessor and preprocessor options The user has the ability to change the preprocessor and preprocessor options
used. For instance, to use gcc as the preprocessor and to ignore system used.
For instance, to use gcc as the preprocessor and to ignore system
headers, one would use headers, one would use
.Bd -literal -offset indent .Bd -literal -offset indent
depend: depend:
@ -101,12 +102,15 @@ module.
.Sh ENVIRONMENT .Sh ENVIRONMENT
.Bl -tag -width MKDEP_CPP_OPTS .Bl -tag -width MKDEP_CPP_OPTS
.It Ev CC .It Ev CC
Specifies the C compiler to use. The specified compiler is expected to have Specifies the C compiler to use.
The specified compiler is expected to have
options consistent with the GNU C compiler. options consistent with the GNU C compiler.
.It Ev MKDEP_CPP .It Ev MKDEP_CPP
Specifies the preprocessor to use. The default is "${CC} -E". Specifies the preprocessor to use.
The default is "${CC} -E".
.It Ev MKDEP_CPP_OPTS .It Ev MKDEP_CPP_OPTS
Specifies the non-CFLAGS options for the preprocessor. The default is Specifies the non-CFLAGS options for the preprocessor.
The default is
"-M". "-M".
.El .El
.Sh SEE ALSO .Sh SEE ALSO

View File

@ -65,7 +65,8 @@ The format of
.Ar src-file .Ar src-file
is quite simple. is quite simple.
It consists of a series of lines which start with a keyword and have It consists of a series of lines which start with a keyword and have
associated data following. C style comments are used associated data following.
C style comments are used
to place comments in the file. to place comments in the file.
.Pp .Pp
Following options are available: Following options are available:
@ -121,9 +122,11 @@ Used to indicate ranges.
The follow characters are taken literally: The follow characters are taken literally:
.Bl -tag -width ".Dv <\|\|(\|\|[" .Bl -tag -width ".Dv <\|\|(\|\|["
.It Dv "<\|(\|[" .It Dv "<\|(\|["
Used to start a mapping. All are equivalent. Used to start a mapping.
All are equivalent.
.It Dv ">\|\^)\|]" .It Dv ">\|\^)\|]"
Used to end a mapping. All are equivalent. Used to end a mapping.
All are equivalent.
.It Dv : .It Dv :
Used as a delimiter in mappings. Used as a delimiter in mappings.
.El .El

View File

@ -54,8 +54,10 @@
The The
.Nm .Nm
utility takes each of the given file name templates and overwrites a utility takes each of the given file name templates and overwrites a
portion of it to create a file name. This file name is unique portion of it to create a file name.
and suitable for use by the application. The template may be This file name is unique
and suitable for use by the application.
The template may be
any file name with some number of any file name with some number of
.Ql X Ns s .Ql X Ns s
appended appended
@ -110,12 +112,16 @@ The
.Nm .Nm
utility is provided to allow shell scripts to safely use temporary files. utility is provided to allow shell scripts to safely use temporary files.
Traditionally, many shell scripts take the name of the program with Traditionally, many shell scripts take the name of the program with
the pid as a suffix and use that as a temporary file name. This the pid as a suffix and use that as a temporary file name.
This
kind of naming scheme is predictable and the race condition it creates kind of naming scheme is predictable and the race condition it creates
is easy for an attacker to win. A safer, though still inferior, approach is easy for an attacker to win.
is to make a temporary directory using the same naming scheme. While A safer, though still inferior, approach
is to make a temporary directory using the same naming scheme.
While
this does allow one to guarantee that a temporary file will not be this does allow one to guarantee that a temporary file will not be
subverted, it still allows a simple denial of service attack. For these subverted, it still allows a simple denial of service attack.
For these
reasons it is suggested that reasons it is suggested that
.Nm .Nm
be used instead. be used instead.
@ -125,7 +131,8 @@ The available options are as follows:
.It Fl d .It Fl d
Make a directory instead of a file. Make a directory instead of a file.
.It Fl q .It Fl q
Fail silently if an error occurs. This is useful if Fail silently if an error occurs.
This is useful if
a script does not want error output to go to standard error. a script does not want error output to go to standard error.
.It Fl t Ar prefix .It Fl t Ar prefix
Generate a template (using the supplied Generate a template (using the supplied
@ -136,11 +143,14 @@ if set) to create a filename template.
.It Fl u .It Fl u
Operate in Operate in
.Dq unsafe .Dq unsafe
mode. The temp file will be unlinked before mode.
The temp file will be unlinked before
.Nm .Nm
exits. This is slightly better than exits.
This is slightly better than
.Xr mktemp 3 .Xr mktemp 3
but still introduces a race condition. Use of this but still introduces a race condition.
Use of this
option is not encouraged. option is not encouraged.
.El .El
.Sh DIAGNOSTICS .Sh DIAGNOSTICS

View File

@ -50,7 +50,8 @@ The
utility is used to give commands to a magnetic tape drive. utility is used to give commands to a magnetic tape drive.
By default By default
.Nm .Nm
performs the requested operation once. Operations performs the requested operation once.
Operations
may be performed multiple times by specifying may be performed multiple times by specifying
.Ar count . .Ar count .
Note Note
@ -58,7 +59,8 @@ that
.Ar tapename .Ar tapename
must reference a raw (not block) tape device. must reference a raw (not block) tape device.
.Pp .Pp
The available commands are listed below. Only as many The available commands are listed below.
Only as many
characters as are required to uniquely identify a command characters as are required to uniquely identify a command
need be specified. need be specified.
.Bl -tag -width "eof, weof" .Bl -tag -width "eof, weof"
@ -146,19 +148,24 @@ Print (and clear) error status information about this device.
For every normal For every normal
operation (e.g., a read or a write) and every control operation (e.g,, a operation (e.g., a read or a write) and every control operation (e.g,, a
rewind), the driver stores up the last command executed and it's associated rewind), the driver stores up the last command executed and it's associated
status and any residual counts (if any). This command retrieves and prints this status and any residual counts (if any).
This command retrieves and prints this
information. information.
If possible, this also clears any latched error information. If possible, this also clears any latched error information.
.It Cm blocksize .It Cm blocksize
Set the block size for the tape unit. Zero means variable-length Set the block size for the tape unit.
Zero means variable-length
blocks. blocks.
.It Cm density .It Cm density
Set the density for the tape unit. For the density codes, see below. Set the density for the tape unit.
For the density codes, see below.
The density value could be given either numerically, or as a string, The density value could be given either numerically, or as a string,
corresponding to the corresponding to the
.Dq Reference .Dq Reference
field. If the string is abbreviated, it will be resolved in the order field.
shown in the table, and the first matching entry will be used. If the If the string is abbreviated, it will be resolved in the order
shown in the table, and the first matching entry will be used.
If the
given string and the resulting canonical density name do not match given string and the resulting canonical density name do not match
exactly, an informational message is printed about what the given exactly, an informational message is printed about what the given
string has been taken for. string has been taken for.
@ -209,11 +216,13 @@ DCLZ compression algorithm (0x20).
.El .El
.Pp .Pp
In addition to the above recognized compression keywords, the user can In addition to the above recognized compression keywords, the user can
supply a numeric compression algorithm for the tape drive to use. In most supply a numeric compression algorithm for the tape drive to use.
In most
cases, simply turning the compression cases, simply turning the compression
.Sq on .Sq on
will have the desired effect of enabling the default compression algorithm will have the desired effect of enabling the default compression algorithm
supported by the drive. If this is not the case (see the supported by the drive.
If this is not the case (see the
.Cm status .Cm status
display to see which compression algorithm is currently in use), the user display to see which compression algorithm is currently in use), the user
can manually specify one of the supported compression keywords (above), or can manually specify one of the supported compression keywords (above), or

View File

@ -85,7 +85,8 @@ associated with the
If not specified, If not specified,
.Nm ncal .Nm ncal
tries to guess the switch date from the local environment or tries to guess the switch date from the local environment or
falls back to September 2, 1752. This was when Great falls back to September 2, 1752.
This was when Great
Britain and her colonies switched to the Gregorian Calendar. Britain and her colonies switched to the Gregorian Calendar.
.It Fl w .It Fl w
Print the number of the week below each week column. Print the number of the week below each week column.

View File

@ -19,7 +19,7 @@ The
utility will schedule a connection created by utility will schedule a connection created by
.Xr ncplogin 1 .Xr ncplogin 1
command to be closed. command to be closed.
If the connection is busy (i.e. used by other processes) it will If the connection is busy (i.e., used by other processes) it will
be closed when the last process using it is terminated. be closed when the last process using it is terminated.
This command is similar to the This command is similar to the
.Tn DOS .Tn DOS

View File

@ -67,7 +67,8 @@ Extract the name list from the specified system instead of the default
.It Fl s .It Fl s
Only display server side statistics Only display server side statistics
.It Fl W .It Fl W
Use wide format with interval short summary. This option is especially Use wide format with interval short summary.
This option is especially
useful when combined with -c or -s and a time delay. useful when combined with -c or -s and a time delay.
.It Fl w .It Fl w
Display a shorter summary of Display a shorter summary of

View File

@ -89,8 +89,10 @@ The
.Nm .Nm
utility treats the text it reads in terms of logical pages. utility treats the text it reads in terms of logical pages.
Unless specified otherwise, line numbering is reset at the start of each Unless specified otherwise, line numbering is reset at the start of each
logical page. A logical page consists of a header, a body and a footer logical page.
section; empty sections are valid. Different line numbering options are A logical page consists of a header, a body and a footer
section; empty sections are valid.
Different line numbering options are
independently available for header, body and footer sections. independently available for header, body and footer sections.
.Pp .Pp
The starts of logical page sections are signalled by input lines containing The starts of logical page sections are signalled by input lines containing
@ -132,7 +134,8 @@ for logical page body lines is
.Cm t . .Cm t .
.It Fl d Ar delim .It Fl d Ar delim
Specify the delimiter characters used to indicate the start of a logical Specify the delimiter characters used to indicate the start of a logical
page section in the input file. At most two characters may be specified; page section in the input file.
At most two characters may be specified;
if only one character is specified, the first character is replaced and the if only one character is specified, the first character is replaced and the
second character remains unchanged. second character remains unchanged.
The default The default

View File

@ -76,10 +76,12 @@ The new password should contain a mixture of upper and lower case
characters (which may be overridden using the characters (which may be overridden using the
.Xr login.conf 5 .Xr login.conf 5
.Dq mixpasswordcase .Dq mixpasswordcase
setting for a user's login class). Allowing lower case passwords may setting for a user's login class).
Allowing lower case passwords may
be useful where the password file will be used in situations where only be useful where the password file will be used in situations where only
lower case passwords are permissible, such as when using Samba to lower case passwords are permissible, such as when using Samba to
authenticate Windows clients. In all other situations, numbers, upper authenticate Windows clients.
In all other situations, numbers, upper
case letters and meta characters are encouraged. case letters and meta characters are encouraged.
.Pp .Pp
Once the password has been verified, Once the password has been verified,

View File

@ -131,22 +131,26 @@ For
.Cm c , d , .Cm c , d ,
and and
.Cm s , .Cm s ,
formats, this option has no effect. For the formats, this option has no effect.
For the
.Cm o .Cm o
formats the precision of the number is increased to force the first formats the precision of the number is increased to force the first
character of the output string to a zero. For the character of the output string to a zero.
For the
.Cm x .Cm x
.Pq Cm X .Pq Cm X
format, a non-zero result has the string format, a non-zero result has the string
.Li 0x .Li 0x
.Pq Li 0X .Pq Li 0X
prepended to it. For prepended to it.
For
.Cm e , E , f , g , .Cm e , E , f , g ,
and and
.Cm G , .Cm G ,
formats, the result will always contain a decimal point, even if no formats, the result will always contain a decimal point, even if no
digits follow the point (normally, a decimal point only appears in the digits follow the point (normally, a decimal point only appears in the
results of those formats if a digit follows the decimal point). For results of those formats if a digit follows the decimal point).
For
.Cm g .Cm g
and and
.Cm G .Cm G
@ -161,10 +165,12 @@ A `+' character specifying that there should always be
a sign placed before the number when using signed formats. a sign placed before the number when using signed formats.
.It Sq \&\ \& .It Sq \&\ \&
A space specifying that a blank should be left before a positive number A space specifying that a blank should be left before a positive number
for a signed format. A `+' overrides a space if both are used; for a signed format.
A `+' overrides a space if both are used;
.It Cm \&0 .It Cm \&0
A zero `0' character indicating that zero-padding should be used A zero `0' character indicating that zero-padding should be used
rather than blank-padding. A `\-' overrides a `0' if both are used; rather than blank-padding.
A `\-' overrides a `0' if both are used;
.El .El
.It "Field Width:" .It "Field Width:"
An optional digit string specifying a An optional digit string specifying a
@ -324,7 +330,8 @@ then back again, floating-point precision may be lost.
.Tn ANSI .Tn ANSI
hexadecimal character constants were deliberately not provided. hexadecimal character constants were deliberately not provided.
.Pp .Pp
The escape sequence \e000 is the string terminator. When present in the The escape sequence \e000 is the string terminator.
When present in the
.Ar format , .Ar format ,
the the
.Ar format .Ar format

View File

@ -90,7 +90,8 @@ This specification may be as a literal character, or as an octal
value in the form \ennn. value in the form \ennn.
.It Fl i .It Fl i
Allow the caller to specify a different local name to be used Allow the caller to specify a different local name to be used
for authentication. This option is restricted to processes with uid 0. for authentication.
This option is restricted to processes with uid 0.
.It Fl l .It Fl l
Specify a different Specify a different
.Ar username .Ar username

View File

@ -260,7 +260,8 @@ routines.
.It Fl C .It Fl C
Generate header and stub files which can be used with Generate header and stub files which can be used with
.Tn ANSI .Tn ANSI
C compilers. Headers generated with this flag can also be C compilers.
Headers generated with this flag can also be
used with C++ programs. used with C++ programs.
.It Fl D Ns Ar name .It Fl D Ns Ar name
.It Fl D Ns Ar name=value .It Fl D Ns Ar name=value
@ -294,7 +295,8 @@ Note: in order to provide backwards compatibility with the older
on the on the
.Fx .Fx
platform, the default is actually 0 (which means platform, the default is actually 0 (which means
that inline code generation is disabled by default). You must specify that inline code generation is disabled by default).
You must specify
a non-zero value explicitly to override this default. a non-zero value explicitly to override this default.
.It Fl I .It Fl I
Compile support for Compile support for

View File

@ -106,7 +106,8 @@ This may introduce a significant delay in response time.
.It Fl t Ar timeout .It Fl t Ar timeout
Allow a Allow a
.Ar timeout .Ar timeout
to be specified (in seconds). If no to be specified (in seconds).
If no
data is sent or received in this time, data is sent or received in this time,
.Nm .Nm
will exit. will exit.

View File

@ -75,14 +75,16 @@ The
.Xr rpc.rstatd 8 .Xr rpc.rstatd 8
daemon has not been started on the remote host. daemon has not been started on the remote host.
.It rup: RPC: Timed out .It rup: RPC: Timed out
A communication error occurred. Either the network is A communication error occurred.
Either the network is
excessively congested, or the excessively congested, or the
.Xr rpc.rstatd 8 .Xr rpc.rstatd 8
daemon has terminated on the remote host. daemon has terminated on the remote host.
.It rup: RPC: Port mapper failure - RPC: Timed out .It rup: RPC: Port mapper failure - RPC: Timed out
The remote host is not running the portmapper (see The remote host is not running the portmapper (see
.Xr rpcbind 8 ) , .Xr rpcbind 8 ) ,
and cannot accommodate any RPC-based services. The host may be down. and cannot accommodate any RPC-based services.
The host may be down.
.El .El
.Sh SEE ALSO .Sh SEE ALSO
.Xr rpc.rstatd 8 , .Xr rpc.rstatd 8 ,

View File

@ -64,7 +64,8 @@ report has been received for 4 days are not shown in the list at all.
The options are as follows: The options are as follows:
.Bl -tag -width Ds .Bl -tag -width Ds
.It Fl a .It Fl a
Include all users. By default, if a user hasn't typed to the system for Include all users.
By default, if a user hasn't typed to the system for
an hour or more, then the user will be omitted from the output. an hour or more, then the user will be omitted from the output.
.It Fl l .It Fl l
Sort by load average. Sort by load average.

View File

@ -81,14 +81,16 @@ The
.Xr rpc.rusersd 8 .Xr rpc.rusersd 8
daemon has not been started on the remote host. daemon has not been started on the remote host.
.It rusers: RPC: Timed out .It rusers: RPC: Timed out
A communication error occurred. Either the network is A communication error occurred.
Either the network is
excessively congested, or the excessively congested, or the
.Xr rpc.rusersd 8 .Xr rpc.rusersd 8
daemon has terminated on the remote host. daemon has terminated on the remote host.
.It rusers: "RPC: Port mapper failure - RPC: Timed out" .It rusers: "RPC: Port mapper failure - RPC: Timed out"
The remote host is not running the portmapper (see The remote host is not running the portmapper (see
.Xr rpcbind 8 ) , .Xr rpcbind 8 ) ,
and cannot accommodate any RPC-based services. The host may be down. and cannot accommodate any RPC-based services.
The host may be down.
.El .El
.Sh SEE ALSO .Sh SEE ALSO
.Xr rwho 1 , .Xr rwho 1 ,

View File

@ -58,14 +58,16 @@ The
.Xr rpc.rwalld 8 .Xr rpc.rwalld 8
daemon has not been started on the remote host. daemon has not been started on the remote host.
.It rwall: RPC: Timed out .It rwall: RPC: Timed out
A communication error occurred. Either the network is A communication error occurred.
Either the network is
excessively congested, or the excessively congested, or the
.Xr rpc.rwalld 8 .Xr rpc.rwalld 8
daemon has terminated on the remote host. daemon has terminated on the remote host.
.It rwall: RPC: Port mapper failure - RPC: Timed out .It rwall: RPC: Port mapper failure - RPC: Timed out
The remote host is not running the portmapper (see The remote host is not running the portmapper (see
.Xr rpcbind 8 ) , .Xr rpcbind 8 ) ,
and cannot accomodate any RPC-based services. The host may be down. and cannot accomodate any RPC-based services.
The host may be down.
.El .El
.Sh SEE ALSO .Sh SEE ALSO
.Xr who 1 , .Xr who 1 ,

View File

@ -81,10 +81,12 @@ Log keys sent to program as well as output.
.It Fl q .It Fl q
Run in quiet mode, omit the start and stop status messages. Run in quiet mode, omit the start and stop status messages.
.It Fl t Ar time .It Fl t Ar time
Specify time interval between flushing script output file. A value of 0 Specify time interval between flushing script output file.
A value of 0
causes causes
.Nm .Nm
to flush for every character I/O event. The default interval is to flush for every character I/O event.
The default interval is
30 seconds. 30 seconds.
.El .El
.Pp .Pp
@ -150,6 +152,8 @@ because of argument parsing compatibility issues.
.Pp .Pp
When running in When running in
.Fl k .Fl k
mode, echo cancelling is far from ideal. The slave terminal mode is checked mode, echo cancelling is far from ideal.
for ECHO mode to check when to avoid manual echo logging. This does not The slave terminal mode is checked
for ECHO mode to check when to avoid manual echo logging.
This does not
work when in a raw mode where the program being run is doing manual echo. work when in a raw mode where the program being run is doing manual echo.

View File

@ -155,16 +155,21 @@ A command line with no addresses selects every pattern space.
A command line with one address selects all of the pattern spaces A command line with one address selects all of the pattern spaces
that match the address. that match the address.
.Pp .Pp
A command line with two addresses selects an inclusive range. This A command line with two addresses selects an inclusive range.
This
range starts with the first pattern space that matches the first range starts with the first pattern space that matches the first
address. The end of the range is the next following pattern space address.
that matches the second address. If the second address is a number The end of the range is the next following pattern space
that matches the second address.
If the second address is a number
less than or equal to the line number first selected, only that less than or equal to the line number first selected, only that
line is selected. In the case when the second address is a context line is selected.
In the case when the second address is a context
address, address,
.Nm .Nm
does not re-match the second address against the does not re-match the second address against the
pattern space that matched the first address. Starting at the pattern space that matched the first address.
Starting at the
first line following the selected range, first line following the selected range,
.Nm .Nm
starts looking again for the first address. starts looking again for the first address.
@ -212,7 +217,7 @@ One special feature of
.Nm .Nm
regular expressions is that they can default to the last regular regular expressions is that they can default to the last regular
expression used. expression used.
If a regular expression is empty, i.e. just the delimiter characters If a regular expression is empty, i.e., just the delimiter characters
are specified, the last regular expression encountered is used instead. are specified, the last regular expression encountered is used instead.
The last regular expression is defined as the last regular expression The last regular expression is defined as the last regular expression
used as part of an address or substitute command, and at run-time, not used as part of an address or substitute command, and at run-time, not
@ -537,7 +542,9 @@ extension and may not be available on other operating systems.
.Sh HISTORY .Sh HISTORY
A A
.Nm .Nm
command, written by L. E. McMahon, appeared in command, written by
.An L. E. McMahon ,
appeared in
.At v7 . .At v7 .
.Sh AUTHORS .Sh AUTHORS
.An "Diomidis D. Spinellis" Aq dds@FreeBSD.org .An "Diomidis D. Spinellis" Aq dds@FreeBSD.org

View File

@ -204,7 +204,8 @@ You will be asked for man's password unless your real UID is 0.
Same as above, but the target command consists of more than a Same as above, but the target command consists of more than a
single word and hence is quoted for use with the single word and hence is quoted for use with the
.Fl c .Fl c
option being passed to the shell. (Most shells expect the argument to option being passed to the shell.
(Most shells expect the argument to
.Fl c .Fl c
to be a single word). to be a single word).
.It Li "su -c staff man -c 'catman /usr/share/man /usr/local/man /usr/X11R6/man'" .It Li "su -c staff man -c 'catman /usr/share/man /usr/local/man /usr/X11R6/man'"

View File

@ -52,16 +52,20 @@ using the curses screen display library,
While While
.Nm .Nm
is running the screen is usually divided into two windows (an exception is running the screen is usually divided into two windows (an exception
is the vmstat display which uses the entire screen). The is the vmstat display which uses the entire screen).
upper window depicts the current system load average. The The
upper window depicts the current system load average.
The
information displayed in the lower window may vary, depending on information displayed in the lower window may vary, depending on
user commands. The last line on the screen is reserved for user user commands.
The last line on the screen is reserved for user
input and error messages. input and error messages.
.Pp .Pp
By default By default
.Nm .Nm
displays the processes getting the largest percentage of the processor displays the processes getting the largest percentage of the processor
in the lower window. Other displays show swap space usage, disk in the lower window.
Other displays show swap space usage, disk
.Tn I/O .Tn I/O
statistics (a la statistics (a la
.Xr iostat 8 ) , .Xr iostat 8 ) ,
@ -76,7 +80,8 @@ and network connections (a la
Input is interpreted at two different levels. Input is interpreted at two different levels.
A ``global'' command interpreter processes all keyboard input. A ``global'' command interpreter processes all keyboard input.
If this command interpreter fails to recognize a command, the If this command interpreter fails to recognize a command, the
input line is passed to a per-display command interpreter. This input line is passed to a per-display command interpreter.
This
allows each display to have certain display-specific commands. allows each display to have certain display-specific commands.
.Pp .Pp
Command line options: Command line options:
@ -121,7 +126,8 @@ Print the name of the current ``display'' being shown in
the lower window and the refresh interval. the lower window and the refresh interval.
.It Ic \&: .It Ic \&:
Move the cursor to the command line and interpret the input Move the cursor to the command line and interpret the input
line typed as a command. While entering a command the line typed as a command.
While entering a command the
current character erase, word erase, and line kill characters current character erase, word erase, and line kill characters
may be used. may be used.
.El .El
@ -140,7 +146,8 @@ Stop refreshing the screen.
.Op Ic start .Op Ic start
.Op Ar number .Op Ar number
.Xc .Xc
Start (continue) refreshing the screen. If a second, numeric, Start (continue) refreshing the screen.
If a second, numeric,
argument is provided it is interpreted as a refresh interval argument is provided it is interpreted as a refresh interval
(in seconds). (in seconds).
Supplying only a number will set the refresh interval to this Supplying only a number will set the refresh interval to this
@ -194,7 +201,8 @@ The
.Ic reset .Ic reset
command resets the baseline for command resets the baseline for
.Ic since .Ic since
mode. The mode.
The
.Ic mode .Ic mode
command with no argument will display the current mode in the command command with no argument will display the current mode in the command
line. line.
@ -228,15 +236,19 @@ but with
statistics. statistics.
.It Ic iostat .It Ic iostat
Display, in the lower window, statistics about processor use Display, in the lower window, statistics about processor use
and disk throughput. Statistics on processor use appear as and disk throughput.
Statistics on processor use appear as
bar graphs of the amount of time executing in user mode (``user''), bar graphs of the amount of time executing in user mode (``user''),
in user mode running low priority processes (``nice''), in in user mode running low priority processes (``nice''), in
system mode (``system''), in interrupt mode (``interrupt''), system mode (``system''), in interrupt mode (``interrupt''),
and idle (``idle''). Statistics and idle (``idle'').
Statistics
on disk throughput show, for each drive, megabytes per second, on disk throughput show, for each drive, megabytes per second,
average number of disk transactions per second, and average number of disk transactions per second, and
average kilobytes of data per transaction. This information may be average kilobytes of data per transaction.
displayed as bar graphs or as rows of numbers which scroll downward. Bar This information may be
displayed as bar graphs or as rows of numbers which scroll downward.
Bar
graphs are shown by default. graphs are shown by default.
.Pp .Pp
The following commands are specific to the The following commands are specific to the
@ -247,7 +259,8 @@ display; the minimum unambiguous prefix may be supplied.
.It Cm numbers .It Cm numbers
Show the disk Show the disk
.Tn I/O .Tn I/O
statistics in numeric form. Values are statistics in numeric form.
Values are
displayed in numeric columns which scroll downward. displayed in numeric columns which scroll downward.
.It Cm bars .It Cm bars
Show the disk Show the disk
@ -272,7 +285,7 @@ a total line is also shown.
Areas known to the kernel, but not in use are shown as not available. Areas known to the kernel, but not in use are shown as not available.
.It Ic mbufs .It Ic mbufs
Display, in the lower window, the number of mbufs allocated Display, in the lower window, the number of mbufs allocated
for particular uses, i.e. data, socket structures, etc. for particular uses, i.e., data, socket structures, etc.
.It Ic vmstat .It Ic vmstat
Take over the entire display and show a (rather crowded) compendium Take over the entire display and show a (rather crowded) compendium
of statistics related to virtual memory usage, process scheduling, of statistics related to virtual memory usage, process scheduling,
@ -325,9 +338,12 @@ It reports the number of
kilobytes per transaction, transactions per second, megabytes kilobytes per transaction, transactions per second, megabytes
per second and the percentage of the time the disk was busy averaged per second and the percentage of the time the disk was busy averaged
over the refresh period of the display (by default, five seconds). over the refresh period of the display (by default, five seconds).
The system keeps statistics on most every storage device. In general, up The system keeps statistics on most every storage device.
to seven devices are displayed. The devices displayed by default are the In general, up
first devices in the kernel's device list. See to seven devices are displayed.
The devices displayed by default are the
first devices in the kernel's device list.
See
.Xr devstat 3 .Xr devstat 3
and and
.Xr devstat 9 .Xr devstat 9
@ -400,10 +416,13 @@ Toggle the display of fd devices in the disk usage display.
Reset running statistics to zero. Reset running statistics to zero.
.El .El
.It Ic netstat .It Ic netstat
Display, in the lower window, network connections. By default, Display, in the lower window, network connections.
network servers awaiting requests are not displayed. Each address By default,
network servers awaiting requests are not displayed.
Each address
is displayed in the format ``host.port'', with each shown symbolically, is displayed in the format ``host.port'', with each shown symbolically,
when possible. It is possible to have addresses displayed numerically, when possible.
It is possible to have addresses displayed numerically,
limit the display to a set of ports, hosts, and/or protocols limit the display to a set of ports, hosts, and/or protocols
(the minimum unambiguous prefix may be supplied): (the minimum unambiguous prefix may be supplied):
.Pp .Pp
@ -424,21 +443,27 @@ Display only network connections using the indicated
Supported protocols are ``tcp'', ``udp'', and ``all''. Supported protocols are ``tcp'', ``udp'', and ``all''.
.It Cm ignore Op Ar items .It Cm ignore Op Ar items
Do not display information about connections associated with Do not display information about connections associated with
the specified hosts or ports. Hosts and ports may be specified the specified hosts or ports.
by name (``vangogh'', ``ftp''), or numerically. Host addresses Hosts and ports may be specified
use the Internet dot notation (``128.32.0.9''). Multiple items by name (``vangogh'', ``ftp''), or numerically.
Host addresses
use the Internet dot notation (``128.32.0.9'').
Multiple items
may be specified with a single command by separating them with may be specified with a single command by separating them with
spaces. spaces.
.It Cm display Op Ar items .It Cm display Op Ar items
Display information about the connections associated with the Display information about the connections associated with the
specified hosts or ports. As for specified hosts or ports.
As for
.Ar ignore , .Ar ignore ,
.Op Ar items .Op Ar items
may be names or numbers. may be names or numbers.
.It Cm show Op Ar ports\&|hosts .It Cm show Op Ar ports\&|hosts
Show, on the command line, the currently selected protocols, Show, on the command line, the currently selected protocols,
hosts, and ports. Hosts and ports which are being ignored hosts, and ports.
are prefixed with a `!'. If Hosts and ports which are being ignored
are prefixed with a `!'.
If
.Ar ports .Ar ports
or or
.Ar hosts .Ar hosts
@ -451,15 +476,18 @@ Reset the port, host, and protocol matching mechanisms to the default
.El .El
.It Ic ifstat .It Ic ifstat
Display the network traffic going through active interfaces on the Display the network traffic going through active interfaces on the
system. Idle interfaces will not be displayed until they receive some system.
Idle interfaces will not be displayed until they receive some
traffic. traffic.
.Pp .Pp
For each interface being displayed, the current, peak and total For each interface being displayed, the current, peak and total
statistics are displayed for incoming and outgoing traffic. By default, statistics are displayed for incoming and outgoing traffic.
By default,
the the
.Ic ifstat .Ic ifstat
display will automatically scale the units being used so that they are display will automatically scale the units being used so that they are
in a human-readable format. The scaling units used for the current and in a human-readable format.
The scaling units used for the current and
peak peak
traffic columns can be altered by the traffic columns can be altered by the
.Ic scale .Ic scale
@ -467,7 +495,8 @@ command.
.Bl -tag -width ".Cm scale Op Ar units" .Bl -tag -width ".Cm scale Op Ar units"
.It Cm scale Op Ar units .It Cm scale Op Ar units
Modify the scale used to display the current and peak traffic over all Modify the scale used to display the current and peak traffic over all
interfaces. The following units are recognised: kbit, kbyte, mbit, interfaces.
The following units are recognised: kbit, kbyte, mbit,
mbyte, gbit, gbyte and auto. mbyte, gbit, gbyte and auto.
.El .El
.El .El
@ -475,28 +504,34 @@ mbyte, gbit, gbyte and auto.
Commands to switch between displays may be abbreviated to the Commands to switch between displays may be abbreviated to the
minimum unambiguous prefix; for example, ``io'' for ``iostat''. minimum unambiguous prefix; for example, ``io'' for ``iostat''.
Certain information may be discarded when the screen size is Certain information may be discarded when the screen size is
insufficient for display. For example, on a machine with 10 insufficient for display.
For example, on a machine with 10
drives the drives the
.Ic iostat .Ic iostat
bar graph displays only 3 drives on a 24 line terminal. When bar graph displays only 3 drives on a 24 line terminal.
When
a bar graph would overflow the allotted screen space it is a bar graph would overflow the allotted screen space it is
truncated and the actual value is printed ``over top'' of the bar. truncated and the actual value is printed ``over top'' of the bar.
.Pp .Pp
The following commands are common to each display which shows The following commands are common to each display which shows
information about disk drives. These commands are used to information about disk drives.
These commands are used to
select a set of drives to report on, should your system have select a set of drives to report on, should your system have
more drives configured than can normally be displayed on the more drives configured than can normally be displayed on the
screen. screen.
.Pp .Pp
.Bl -tag -width Ar -compact .Bl -tag -width Ar -compact
.It Cm ignore Op Ar drives .It Cm ignore Op Ar drives
Do not display information about the drives indicated. Multiple Do not display information about the drives indicated.
Multiple
drives may be specified, separated by spaces. drives may be specified, separated by spaces.
.It Cm display Op Ar drives .It Cm display Op Ar drives
Display information about the drives indicated. Multiple drives Display information about the drives indicated.
Multiple drives
may be specified, separated by spaces. may be specified, separated by spaces.
.It Cm only Op Ar drives .It Cm only Op Ar drives
Display only the specified drives. Multiple drives may be specified, Display only the specified drives.
Multiple drives may be specified,
separated by spaces. separated by spaces.
.It Cm drives .It Cm drives
Display a list of available devices. Display a list of available devices.
@ -504,10 +539,12 @@ Display a list of available devices.
.Ar type , Ns Ar if , Ns Ar pass .Ar type , Ns Ar if , Ns Ar pass
.Op | Ar ... .Op | Ar ...
.Xc .Xc
Display devices matching the given pattern. The basic matching Display devices matching the given pattern.
The basic matching
expressions are the same as those used in expressions are the same as those used in
.Xr iostat 8 .Xr iostat 8
with one difference. Instead of specifying multiple with one difference.
Instead of specifying multiple
.Fl t .Fl t
arguments which are then ORed together, the user instead specifies multiple arguments which are then ORed together, the user instead specifies multiple
matching expressions joined by the pipe matching expressions joined by the pipe
@ -515,9 +552,11 @@ matching expressions joined by the pipe
character. character.
The comma The comma
separated arguments within each matching expression are ANDed together, and separated arguments within each matching expression are ANDed together, and
then the pipe separated matching expressions are ORed together. Any then the pipe separated matching expressions are ORed together.
Any
device matching the combined expression will be displayed, if there is room device matching the combined expression will be displayed, if there is room
to display it. For example: to display it.
For example:
.Pp .Pp
.Dl match da,scsi | cd,ide .Dl match da,scsi | cd,ide
.Pp .Pp

View File

@ -172,7 +172,7 @@ and
.Fl n .Fl n
options modify the options modify the
.Fl r .Fl r
option, i.e. ``-r -c 4'' displays the last 4 characters of the last line option, i.e., ``-r -c 4'' displays the last 4 characters of the last line
of the input, while the historic tail (using the historic syntax ``-4cr'') of the input, while the historic tail (using the historic syntax ``-4cr'')
would ignore the would ignore the
.Fl c .Fl c

View File

@ -412,7 +412,8 @@ and
.Cm f .Cm f
flags both require arguments, flags both require arguments,
so there must be two additional items so there must be two additional items
on the command line. The on the command line.
The
.Ar 32 .Ar 32
is the argument to the is the argument to the
.Cm b .Cm b

View File

@ -47,16 +47,20 @@
.Sh DESCRIPTION .Sh DESCRIPTION
The The
.Nm .Nm
utility is designed to copy magnetic tapes. The only assumption made utility is designed to copy magnetic tapes.
The only assumption made
about the tape is that there are two tape marks at the end. about the tape is that there are two tape marks at the end.
The The
.Nm .Nm
utility with only a source tape utility with only a source tape
.Pf ( Ar /dev/sa0 .Pf ( Ar /dev/sa0
by default) specified will print by default) specified will print
information about the sizes of records and tape files. If a destination information about the sizes of records and tape files.
is specified a copy will be made of the source tape. The blocking on the If a destination
destination tape will be identical to that used on the source tape. Copying is specified a copy will be made of the source tape.
The blocking on the
destination tape will be identical to that used on the source tape.
Copying
a tape will yield the same output as if just printing the sizes. a tape will yield the same output as if just printing the sizes.
.Pp .Pp
Options: Options:

View File

@ -178,7 +178,8 @@ Because there is no user-login or validation within
the the
.Tn TFTP .Tn TFTP
protocol, the remote site will probably have some protocol, the remote site will probably have some
sort of file-access restrictions in place. The sort of file-access restrictions in place.
The
exact methods are specific to each site and therefore exact methods are specific to each site and therefore
difficult to document here. difficult to document here.
.Pp .Pp

View File

@ -71,8 +71,9 @@ flag is used, append to the specified file rather than overwriting
it. it.
Otherwise, this option has no effect. Otherwise, this option has no effect.
.It Fl h .It Fl h
Print times in a human friendly format. Times are printed in minutes, hours, Print times in a human friendly format.
etc. as appropriate. Times are printed in minutes, hours,
etc.\& as appropriate.
.It Fl l .It Fl l
The contents of the The contents of the
.Em rusage .Em rusage
@ -80,7 +81,8 @@ structure are printed as well.
.It Fl o Ar file .It Fl o Ar file
Write the output to Write the output to
.Ar file .Ar file
instead of stderr. If instead of stderr.
If
.Ar file .Ar file
exists and the exists and the
.Fl a .Fl a

View File

@ -48,7 +48,8 @@
The The
.Nm .Nm
utility makes terminal-dependent information available to users or shell utility makes terminal-dependent information available to users or shell
applications. When invoked as the applications.
When invoked as the
.Nm clear .Nm clear
utility, the screen will be cleared as if utility, the screen will be cleared as if
.Dl tput clear .Dl tput clear
@ -83,7 +84,7 @@ without further action.
.Pp .Pp
If an If an
.Ar attribute .Ar attribute
is of type string, and takes arguments (e.g. cursor movement, is of type string, and takes arguments (e.g.\& cursor movement,
the termcap the termcap
.Dq cm .Dq cm
sequence) the arguments are taken from the command line immediately sequence) the arguments are taken from the command line immediately
@ -150,6 +151,8 @@ Some termcap entries depend upon having a
.Sq % .Sq %
in them that is just a in them that is just a
.Sq % .Sq %
and nothing more. Right now we just warn about them if they don't and nothing more.
have a valid type declaration. These warnings are sent to Right now we just warn about them if they don't
have a valid type declaration.
These warnings are sent to
stderr. stderr.

View File

@ -291,7 +291,7 @@ System V has historically implemented character ranges using the syntax
implementations and implementations and
standardized by POSIX. standardized by POSIX.
System V shell scripts should work under this implementation as long as System V shell scripts should work under this implementation as long as
the range is intended to map in another range, i.e. the command the range is intended to map in another range, i.e., the command
``tr [a-z] [A-Z]'' will work as it will map the ``['' character in ``tr [a-z] [A-Z]'' will work as it will map the ``['' character in
.Ar string1 .Ar string1
to the ``['' character in to the ``['' character in

View File

@ -154,7 +154,7 @@ and
.Fl k .Fl k
options may either be entered as actual characters or by using the options may either be entered as actual characters or by using the
.Dq hat .Dq hat
notation, i.e. control-h may be specified as notation, i.e., control-h may be specified as
.Dq Li ^H .Dq Li ^H
or or
.Dq Li ^h . .Dq Li ^h .

View File

@ -74,7 +74,8 @@ Turn on debugging.
Search for and display the longest cycle. Search for and display the longest cycle.
Can take a very long time. Can take a very long time.
.It Fl q .It Fl q
Do not display informational messages about cycles. This is primarily Do not display informational messages about cycles.
This is primarily
intended for building libraries, where optimal ordering is not critical, intended for building libraries, where optimal ordering is not critical,
and cycles occur often. and cycles occur often.
.El .El

View File

@ -101,7 +101,8 @@ file (see
The The
.Xr nroff 1 .Xr nroff 1
command usually outputs a series of backspaces and underlines intermixed command usually outputs a series of backspaces and underlines intermixed
with the text to indicate underlining. No attempt is made to optimize with the text to indicate underlining.
No attempt is made to optimize
the backward motion. the backward motion.
.Sh HISTORY .Sh HISTORY
The The

View File

@ -85,7 +85,7 @@ Ignore the first
fields in each input line when doing comparisons. fields in each input line when doing comparisons.
A field is a string of non-blank characters separated from adjacent fields A field is a string of non-blank characters separated from adjacent fields
by blanks. by blanks.
Field numbers are one based, i.e. the first field is field one. Field numbers are one based, i.e., the first field is field one.
.It Fl s Ar chars .It Fl s Ar chars
Ignore the first Ignore the first
.Ar chars .Ar chars
@ -97,7 +97,7 @@ option, the first
characters after the first characters after the first
.Ar num .Ar num
fields will be ignored. fields will be ignored.
Character numbers are one based, i.e. the first character is character one. Character numbers are one based, i.e., the first character is character one.
.It Fl u .It Fl u
Only output lines that are not repeated in the input. Only output lines that are not repeated in the input.
.It Fl i .It Fl i
@ -147,7 +147,7 @@ The
.Nm .Nm
utility conforms to utility conforms to
.St -p1003.1-2001 .St -p1003.1-2001
as amended by Cor. 1-2002. as amended by Cor.\& 1-2002.
.Sh HISTORY .Sh HISTORY
A A
.Nm .Nm

View File

@ -22,18 +22,23 @@ about the number of units loaded.
Print the version number. Print the version number.
.It Ar from-unit to-unit .It Ar from-unit to-unit
Allow a single unit conversion to be done directly from the command Allow a single unit conversion to be done directly from the command
line. The program will not print prompts. It will print out the line.
The program will not print prompts.
It will print out the
result of the single specified conversion. result of the single specified conversion.
.El .El
.Sh DESCRIPTION .Sh DESCRIPTION
The The
.Nm .Nm
program converts quantities expressed in various scales to program converts quantities expressed in various scales to
their equivalents in other scales. The their equivalents in other scales.
The
.Nm .Nm
program can only program can only
handle multiplicative scale changes. It cannot convert Celsius handle multiplicative scale changes.
to Fahrenheit, for example. It works interactively by prompting It cannot convert Celsius
to Fahrenheit, for example.
It works interactively by prompting
the user for input: the user for input:
.Bd -literal .Bd -literal
You have: meters You have: meters
@ -60,11 +65,15 @@ the user for input:
Powers of units can be specified using the '^' character as shown in Powers of units can be specified using the '^' character as shown in
the example, or by simple concatenation: 'cm3' is equivalent to 'cm^3'. the example, or by simple concatenation: 'cm3' is equivalent to 'cm^3'.
Multiplication of units can be specified by using spaces, a dash or 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 ('/').
Note that multiplication has a higher precedence than division, Note that multiplication has a higher precedence than division,
so 'm/s/s' is the same as 'm/s^2' or 'm/s s'. Division of numbers so 'm/s/s' is the same as 'm/s^2' or 'm/s s'.
must be indicated using the vertical bar ('|'). To convert half a Division of numbers
meter, you would write '1|2 meter'. If you write '1/2 meter' then the must be indicated using the vertical bar ('|').
To convert half a
meter, you would write '1|2 meter'.
If you write '1/2 meter' then the
units program would interpret that as equivalent to '0.5/meter'. units program would interpret that as equivalent to '0.5/meter'.
If you enter incompatible unit types, the units program will If you enter incompatible unit types, the units program will
print a message indicating that the units are not conformable and print a message indicating that the units are not conformable and
@ -77,9 +86,11 @@ it will display the reduced form for each unit:
2.1166667e-05 kg^2 m / sec 2.1166667e-05 kg^2 m / sec
.Ed .Ed
.Pp .Pp
The conversion information is read from a units data file. The default The conversion information is read from a units data file.
The default
file includes definitions for most familiar units, abbreviations and file includes definitions for most familiar units, abbreviations and
metric prefixes. Some constants of nature included are: metric prefixes.
Some constants of nature included are:
.Pp .Pp
.Bl -column -offset indent -compact "mercury" .Bl -column -offset indent -compact "mercury"
.It "pi ratio of circumference to diameter .It "pi ratio of circumference to diameter
@ -93,11 +104,16 @@ metric prefixes. Some constants of nature included are:
.It "au astronomical unit .It "au astronomical unit
.El .El
.Pp .Pp
The unit 'pound' is a unit of mass. Compound names are run together The unit 'pound' is a unit of mass.
so 'pound force' is a unit of force. The unit 'ounce' is also a unit Compound names are run together
of mass. The fluid ounce is 'floz'. British units that differ from so 'pound force' is a unit of force.
The unit 'ounce' is also a unit
of mass.
The fluid ounce is 'floz'.
British units that differ from
their US counterparts are prefixed with 'br', and currency is prefixed their US counterparts are prefixed with 'br', and currency is prefixed
with its country name: 'belgiumfranc', 'britainpound'. When searching with its country name: 'belgiumfranc', 'britainpound'.
When searching
for a unit, if the specified string does not appear exactly as a unit for a unit, if the specified string does not appear exactly as a unit
name, then name, then
.Nm .Nm
@ -107,19 +123,23 @@ trailing 'es' and check again for a match.
To find out what units are available read the standard units file. To find out what units are available read the standard units file.
If you want to add your own units you can supply your own file. If you want to add your own units you can supply your own file.
A unit is specified on a single line by A unit is specified on a single line by
giving its name and an equivalence. Be careful to define giving its name and an equivalence.
Be careful to define
new units in terms of old ones so that a reduction leads to the new units in terms of old ones so that a reduction leads to the
primitive units which are marked with '!' characters. primitive units which are marked with '!' characters.
The The
.Nm .Nm
program will not detect infinite loops that could be caused program will not detect infinite loops that could be caused
by careless unit definitions. Comments in the unit definition file by careless unit definitions.
Comments in the unit definition file
begin with a '/' character at the beginning of a line. begin with a '/' character at the beginning of a line.
.Pp .Pp
Prefixes are defined in the same was as standard units, but with Prefixes are defined in the same was as standard units, but with
a trailing dash at the end of the prefix name. If a unit is not found a trailing dash at the end of the prefix name.
If a unit is not found
even after removing trailing 's' or 'es', then it will be checked even after removing trailing 's' or 'es', then it will be checked
against the list of prefixes. Prefixes will be removed until a legal against the list of prefixes.
Prefixes will be removed until a legal
base unit is identified. base unit is identified.
.Pp .Pp
Here is an example of a short units file that defines some basic Here is an example of a short units file that defines some basic
@ -142,7 +162,8 @@ Exponents entered by the user can be only one digit.
You can work around this by multiplying several terms. You can work around this by multiplying several terms.
.Pp .Pp
The user must use | to indicate division of numbers and / to The user must use | to indicate division of numbers and / to
indicate division of symbols. This distinction should not indicate division of symbols.
This distinction should not
be necessary. be necessary.
.Pp .Pp
The program contains various arbitrary limits on the length The program contains various arbitrary limits on the length

View File

@ -66,7 +66,8 @@ The
.Nm .Nm
utility runs in two basic modes, filter mode (see the utility runs in two basic modes, filter mode (see the
.Fl f .Fl f
option) or regular mode. In filter mode option) or regular mode.
In filter mode
.Nm .Nm
acts as a filter in a manner similar to acts as a filter in a manner similar to
.Xr tbl 1 . .Xr tbl 1 .
@ -81,10 +82,12 @@ starts processing
ends processing ends processing
.El .El
.Pp .Pp
These lines are formatted as described above. The output from this These lines are formatted as described above.
The output from this
filter can be passed to filter can be passed to
.Xr troff 1 .Xr troff 1
for output. There need be no particular ordering with for output.
There need be no particular ordering with
.Xr eqn 1 .Xr eqn 1
or or
.Xr tbl 1 . .Xr tbl 1 .
@ -119,7 +122,8 @@ forces filter mode
specifies a particular header to put on every output page (default is specifies a particular header to put on every output page (default is
the file name) the file name)
.It Fl l .It Fl l
specifies the language to use. Currently known are specifies the language to use.
Currently known are
.Tn PASCAL .Tn PASCAL
.Pq Fl l Ns Ar p , .Pq Fl l Ns Ar p ,
.Tn MODEL .Tn MODEL
@ -198,7 +202,8 @@ followed:
For For
.Tn C .Tn C
\- function names can be preceded on a line only by spaces, tabs, or an \- 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 .Pp
For For
.Tn PASCAL .Tn PASCAL
@ -218,7 +223,8 @@ name comment mechanisms will fail.
More generally, arbitrary formatting styles for programs mostly look bad. More generally, arbitrary formatting styles for programs mostly look bad.
The use of spaces to align source code fails miserably; if you plan to The use of spaces to align source code fails miserably; if you plan to
.Nm .Nm
your program you should use tabs. This is somewhat inevitable since the your program you should use tabs.
This is somewhat inevitable since the
font used by font used by
.Nm .Nm
is variable width. is variable width.

View File

@ -74,7 +74,8 @@ The following table names and describes each field.
.Pp .Pp
Non-comments are required to describe a certain context where a Non-comments are required to describe a certain context where a
sequence that would normally start a comment loses its special sequence that would normally start a comment loses its special
meaning. A typical example for this can be found in Perl, where meaning.
A typical example for this can be found in Perl, where
comments are normally starting with comments are normally starting with
.Ql # , .Ql # ,
while the string while the string
@ -95,7 +96,8 @@ if ifdef ifndef include undef:
.Ed .Ed
.Pp .Pp
Note that the first field is just the language name (and any variants 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 .Xr vgrind 1
as "c" or "C". as "c" or "C".
.Pp .Pp
@ -132,7 +134,8 @@ a delimiter (space, tab, newline, start of line)
.It \ea .It \ea
matches any string of symbols (like .* in lex) matches any string of symbols (like .* in lex)
.It \ep .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. that matches this symbol is used as the procedure name.
.It () .It ()
grouping grouping
@ -148,11 +151,13 @@ string delimiter in a string by escaping it.
.El .El
.Pp .Pp
Unlike other regular expressions in the system, these match words Unlike other regular expressions in the system, these match words
and not characters. Hence something like "(tramp|steamer)flies?" and not characters.
Hence something like "(tramp|steamer)flies?"
would match "tramp", "steamer", "trampflies", or "steamerflies". would match "tramp", "steamer", "trampflies", or "steamerflies".
.Sh KEYWORD LIST .Sh KEYWORD LIST
The keyword list is just a list of keywords in the language separated 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 "oc" boolean is specified, indicating that upper
and lower case are equivalent, then all the keywords should be and lower case are equivalent, then all the keywords should be
specified in lower case. specified in lower case.
.Sh FILES .Sh FILES

View File

@ -47,10 +47,12 @@
The The
.Nm .Nm
utility is a filter for converting non-printable characters utility is a filter for converting non-printable characters
into a visual representation. It differs from into a visual representation.
It differs from
.Ql cat -v .Ql cat -v
in that 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. characters except space, tab, and newline are encoded.
A detailed description of the A detailed description of the
various visual formats is given in various visual formats is given in
@ -60,9 +62,11 @@ The options are as follows:
.Bl -tag -width Ds .Bl -tag -width Ds
.It Fl b .It Fl b
Turns off prepending of backslash before up-arrow control sequences Turns off prepending of backslash before up-arrow control sequences
and meta characters, and disables the doubling of backslashes. This and meta characters, and disables the doubling of backslashes.
This
produces output which is neither invertible or precise, but does produces output which is neither invertible or precise, but does
represent a minimum of change to the input. It is similar to represent a minimum of change to the input.
It is similar to
.Dq Li cat -v . .Dq Li cat -v .
.It Fl c .It Fl c
Request a format which displays a small subset of the Request a format which displays a small subset of the
@ -94,14 +98,16 @@ still doubled and hidden newline sequences inserted if
.Fl f .Fl f
or or
.Fl F .Fl F
is selected. When combined with the is selected.
When combined with the
.Fl f .Fl f
flag, flag,
.Nm .Nm
becomes like becomes like
an invertible version of the an invertible version of the
.Xr fold 1 .Xr fold 1
utility. That is, the output utility.
That is, the output
can be unfolded by running the output through can be unfolded by running the output through
.Xr unvis 1 . .Xr unvis 1 .
.It Fl o .It Fl o

View File

@ -114,7 +114,8 @@ allocation and then by type of usage.
.It Fl n .It Fl n
Change the maximum number of disks to display from the default of 2. Change the maximum number of disks to display from the default of 2.
.It Fl p .It Fl p
Specify which types of devices to display. There are three different Specify which types of devices to display.
There are three different
categories of devices: categories of devices:
.Pp .Pp
.Bl -tag -width indent -compact .Bl -tag -width indent -compact
@ -166,15 +167,18 @@ Passthrough devices
.El .El
.Pp .Pp
The user must specify at least one device type, and may specify at most The user must specify at least one device type, and may specify at most
one device type from each category. Multiple device types in a single one device type from each category.
Multiple device types in a single
device type statement must be separated by commas. device type statement must be separated by commas.
.Pp .Pp
Any number of Any number of
.Fl p .Fl p
arguments may be specified on the command line. All arguments may be specified on the command line.
All
.Fl p .Fl p
arguments are ORed together to form a matching expression against which arguments are ORed together to form a matching expression against which
all devices in the system are compared. Any device that fully matches all devices in the system are compared.
Any device that fully matches
any any
.Fl p .Fl p
argument will be included in the argument will be included in the
@ -262,7 +266,8 @@ If more than three disk drives are configured in the system,
.Nm .Nm
displays only the first three drives, unless the user specifies the displays only the first three drives, unless the user specifies the
.Fl n .Fl n
argument to increase the number of drives displayed. This will probably argument to increase the number of drives displayed.
This will probably
cause the display to exceed 80 columns, however. cause the display to exceed 80 columns, however.
To force To force
.Nm .Nm
@ -272,7 +277,8 @@ The
utility utility
defaults to show disks first, and then various other random devices in the defaults to show disks first, and then various other random devices in the
system to add up to three devices, if there are that many devices in the system to add up to three devices, if there are that many devices in the
system. If devices are specified on the command line, or if a device type system.
If devices are specified on the command line, or if a device type
matching pattern is specified (see above), matching pattern is specified (see above),
.Nm .Nm
will only display the given devices or the devices matching the pattern, will only display the given devices or the devices matching the pattern,

View File

@ -56,7 +56,8 @@ to deny messages or are using a program which
automatically denies messages. automatically denies messages.
.Bl -tag -width indent .Bl -tag -width indent
.It Fl g .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 multiple times, and any user in any of the specified groups will
receive the message. receive the message.
.El .El

View File

@ -50,7 +50,8 @@ utility searches each specified
.Ar file .Ar file
for sequences of the form for sequences of the form
.Dq \&@(#) .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 NUL character, newline, double of the string following this marker, up to a NUL character, newline, double
quote, quote,
.Dq \&> .Dq \&>

View File

@ -51,7 +51,8 @@ The
.Nm .Nm
utility checks the standard binary, manual page, and source utility checks the standard binary, manual page, and source
directories for the specified programs, printing out the paths of any directories for the specified programs, printing out the paths of any
it finds. The supplied program names are first stripped of leading it finds.
The supplied program names are first stripped of leading
path name components, any single trailing extension added by path name components, any single trailing extension added by
.Xr gzip 1 , .Xr gzip 1 ,
.Xr compress 1 , .Xr compress 1 ,
@ -72,7 +73,8 @@ string, with
.Pa /usr/games .Pa /usr/games
and the current user's and the current user's
.Ev $PATH .Ev $PATH
appended. Manual pages are searched by default along the appended.
Manual pages are searched by default along the
.Ev $MANPATH . .Ev $MANPATH .
Program sources are located in a list of known standard places, Program sources are located in a list of known standard places,
including all the subdirectories of including all the subdirectories of
@ -83,15 +85,18 @@ and
The following options are available: The following options are available:
.Bl -tag -width indent .Bl -tag -width indent
.It Fl B .It Fl B
Specify directories to search for binaries. Requires the Specify directories to search for binaries.
Requires the
.Fl f .Fl f
option. option.
.It Fl M .It Fl M
Specify directories to search for manual pages. Requires the Specify directories to search for manual pages.
Requires the
.Fl f .Fl f
option. option.
.It Fl S .It Fl S
Specify directories to search for program sources. Requires the Specify directories to search for program sources.
Requires the
.Fl f .Fl f
option. option.
.It Fl a .It Fl a
@ -121,7 +126,8 @@ Search for source directories.
.It Fl u .It Fl u
Search for Search for
.Dq unusual .Dq unusual
entries. A file is said to be unusual if it does not have at least entries.
A file is said to be unusual if it does not have at least
one entry of each requested type. one entry of each requested type.
Only the name of the unusual entry is printed. Only the name of the unusual entry is printed.
.It Fl x .It Fl x

View File

@ -114,8 +114,10 @@ created.
If If
.Pa /var/log/wtmp .Pa /var/log/wtmp
is being used as the file, the user name may be empty is being used as the file, the user name may be empty
or one of the special characters '|', '}' and '~'. Logouts produce or one of the special characters '|', '}' and '~'.
an output line without any user name. For more information on the Logouts produce
an output line without any user name.
For more information on the
special characters, see special characters, see
.Xr utmp 5 . .Xr utmp 5 .
.Sh ENVIRONMENT .Sh ENVIRONMENT

View File

@ -56,13 +56,17 @@ utility implements a window environment on
terminals. terminals.
.Pp .Pp
A window is a rectangular portion of the physical terminal A window is a rectangular portion of the physical terminal
screen associated with a set of processes. Its size and screen associated with a set of processes.
position can be changed by the user at any time. 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 communicate with their window in the same way they normally
interact with a terminal\-through their standard input, output, 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 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 input from the keyboard, but all windows can simultaneously send output
to the display. to the display.
.Pp .Pp
@ -72,7 +76,8 @@ starts up, the commands (see long commands below)
contained in the file contained in the file
.Pa .windowrc .Pa .windowrc
in the user's home directory are 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. the terminal screen are created by default.
.Pp .Pp
The command line options are The command line options are
@ -82,7 +87,8 @@ Turn on terse mode (see
.Ic terse .Ic terse
command below). command below).
.It Fl f .It Fl f
Fast. Don't perform any startup action. Fast.
Don't perform any startup action.
.It Fl d .It Fl d
Ignore Ignore
.Pa .windowrc .Pa .windowrc
@ -105,30 +111,39 @@ as a long command (see below)
before doing anything else. before doing anything else.
.El .El
.Pp .Pp
Windows can overlap and are framed as necessary. Each window Windows can overlap and are framed as necessary.
is named by one of the digits ``1'' to ``9''. This one-character Each window
is named by one of the digits ``1'' to ``9''.
This one-character
identifier, as well as a user definable label string, are displayed 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 with the window on the top edge of its frame.
A window can be
designated to be in the designated to be in the
.Ar foreground , .Ar foreground ,
in which case it will always be in which case it will always be
on top of all normal, non-foreground windows, and can be covered on top of all normal, non-foreground windows, and can be covered
only by other foreground windows. A window need not be completely only by other foreground windows.
within the edges of the terminal screen. Thus a large window 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 (possibly larger than the screen) may be positioned to show only
a portion of its full size. a portion of its full size.
.Pp .Pp
Each window has a cursor and a set of control functions. Most intelligent Each window has a cursor and a set of control functions.
Most intelligent
terminal operations such as line and terminal operations such as line and
character deletion and insertion are supported. Display modes character deletion and insertion are supported.
Display modes
such as underlining and reverse video are available if they are such as underlining and reverse video are available if they are
supported by the terminal. In addition, supported by the terminal.
In addition,
similar to terminals with multiple pages of memory, similar to terminals with multiple pages of memory,
each window has a text buffer which can have more lines than the window each window has a text buffer which can have more lines than the window
itself. itself.
.Ss Process Environment .Ss Process Environment
With each newly created window, a shell program is spawned with its 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 output, and diagnostic file descriptors are bound to one end of either
a pseudo-terminal (see a pseudo-terminal (see
.Xr pty 4 ) .Xr pty 4 )
@ -140,7 +155,8 @@ If a pseudo-terminal is used, then its special
characters and modes (see characters and modes (see
.Xr stty 1 ) .Xr stty 1 )
are copied from the physical are copied from the physical
terminal. A terminal.
A
.Xr termcap 5 .Xr termcap 5
entry tailored to this window is created entry tailored to this window is created
and passed as environment (see and passed as environment (see
@ -151,9 +167,11 @@ The termcap entry contains the window's size and
characteristics as well as information from the physical terminal, characteristics as well as information from the physical terminal,
such as the existence of underline, reverse video, and other display such as the existence of underline, reverse video, and other display
modes, and the codes produced by the terminal's function keys, 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 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 .Xr vi 1
uses uses
this information to redraw its display. this information to redraw its display.
@ -161,11 +179,14 @@ this information to redraw its display.
During normal execution, During normal execution,
.Nm .Nm
can be in one of two states: 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 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 window--called the current window--and input from the keyboard is sent
to the process in that window. The current window is always to the process in that window.
on top of all other windows, except those in foreground. In addition, 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. it is set apart by highlighting its identifier and label in reverse video.
.Pp .Pp
Typing Typing
@ -173,7 +194,8 @@ Typing
escape character (normally escape character (normally
.Ic ^P ) .Ic ^P )
in conversation 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 the terminal screen becomes the command prompt window, and
.Nm .Nm
interprets input from the keyboard as commands to manipulate windows. interprets input from the keyboard as commands to manipulate windows.
@ -195,7 +217,8 @@ means
.No control\- Ns Ar X , .No control\- Ns Ar X ,
where where
.Ar X .Ar X
is any character. In particular, is any character.
In particular,
.Ic ^^ .Ic ^^
is is
.Li control\-^ . .Li control\-^ .
@ -214,17 +237,20 @@ Select window
but stay in command mode. but stay in command mode.
.It Ic ^^ .It Ic ^^
Select the previous window and return to conversation 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 .It Ic escape
Return to conversation mode. Return to conversation mode.
.It Ic ^P .It Ic ^P
Return to conversation mode and write Return to conversation mode and write
.Ic ^P .Ic ^P
to the to the
current window. Thus, typing two current window.
Thus, typing two
.Ic ^P Ns 's .Ic ^P Ns 's
in conversation in conversation
mode sends one to the current window. If the mode sends one to the current window.
If the
.Nm .Nm
escape is changed to some other character, that escape is changed to some other character, that
character takes the place of character takes the place of
@ -242,23 +268,30 @@ Confirmation is requested.
Suspend Suspend
.Nm . .Nm .
.It Ic w .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. of the upper left and lower right corners of the window.
The cursor is placed on the screen and the keys ``h'', ``j'', The cursor is placed on the screen and the keys ``h'', ``j'',
``k'', and ``l'' ``k'', and ``l''
move the cursor left, down, up, and right, respectively. move the cursor left, down, up, and right, respectively.
The keys ``H'', ``J'', ``K'', and ``L'' move the cursor to the respective The keys ``H'', ``J'', ``K'', and ``L'' move the cursor to the respective
limits of the screen. Typing a number before the movement keys limits of the screen.
repeats the movement that number of times. Return enters the cursor position Typing a number before the movement keys
as the upper left corner of the window. The lower right corner repeats the movement that number of times.
is entered in the same manner. During this process, 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 the placement of the new window is indicated by a rectangular
box drawn on the screen, corresponding to where the new window box drawn on the screen, corresponding to where the new window
will be framed. Typing escape at any point will be framed.
Typing escape at any point
cancels this command. cancels this command.
.Pp .Pp
This window becomes the current window, This window becomes the current window,
and is given the first available ID. The default buffer size and is given the first available ID.
The default buffer size
is used (see is used (see
.Ar default_nline .Ar default_nline
command below). command below).
@ -277,12 +310,14 @@ handle this signal correctly and cause no problems.
.It Ic m Ns Ar # .It Ic m Ns Ar #
Move window Move window
.Ar # .Ar #
to another location. A box in the shape to another location.
A box in the shape
of the window is drawn on of the window is drawn on
the screen to indicate the new position of the window, and the same keys as the screen to indicate the new position of the window, and the same keys as
those for the those for the
.Ic w .Ic w
command are used to position the box. The command are used to position the box.
The
window can be moved partially off-screen. window can be moved partially off-screen.
.It Ic M Ns Ar # .It Ic M Ns Ar #
Move window Move window
@ -292,8 +327,10 @@ to its previous position.
Change the size of window Change the size of window
.Ar # . .Ar # .
The user is prompted The user is prompted
to enter the new lower right corner of the window. A box to enter the new lower right corner of the window.
is drawn to indicate the new window size. The same A box
is drawn to indicate the new window size.
The same
keys used in keys used in
.Ic w .Ic w
and and
@ -324,11 +361,14 @@ Move the cursor of the current window up by one line.
.It Ic l .It Ic l
Move the cursor of the current window right by one column. Move the cursor of the current window right by one column.
.It Ic y .It Ic y
Yank. The user is prompted to enter two points within the current Yank.
window. Then the content of the current window between those two points 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. is saved in the yank buffer.
.It Ic p .It Ic p
Put. The content of the yank buffer is written to the current Put.
The content of the yank buffer is written to the current
window as input. window as input.
.It Ic ^S .It Ic ^S
Stop output in the current window. Stop output in the current window.
@ -343,30 +383,40 @@ are supported.
.Ss Long Commands .Ss Long Commands
Long commands are a sequence of statements Long commands are a sequence of statements
parsed much like a programming language, with a syntax 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. are supported, as well as conditional statements.
.Pp .Pp
There are two data types: string and number. A string is a sequence There are two data types: string and number.
of letters or digits beginning with a letter. ``_'' and ``.'' are A string is a sequence
considered letters. Alternately, non-alphanumeric characters can of letters or digits beginning with a letter.
``_'' and ``.'' are
considered letters.
Alternately, non-alphanumeric characters can
be included in strings by quoting them in ``"'' or escaping them be included in strings by quoting them in ``"'' or escaping them
with ``\\''. In addition, the ``\\'' sequences of C are supported, with ``\\''.
In addition, the ``\\'' sequences of C are supported,
both inside and outside quotes (e.g., ``\\n'' is a new line, both inside and outside quotes (e.g., ``\\n'' is a new line,
``\\r'' a carriage return). For example, these are legal strings: ``\\r'' a carriage return).
For example, these are legal strings:
abcde01234, "&#$^*&#", ab"$#"cd, ab\\$\\#cd, "/usr/ucb/window". abcde01234, "&#$^*&#", ab"$#"cd, ab\\$\\#cd, "/usr/ucb/window".
.Pp .Pp
A number is an integer value in one of three forms: A number is an integer value in one of three forms:
a decimal number, an octal number preceded by ``0'', a decimal number, an octal number preceded by ``0'',
or a hexadecimal number preceded by ``0x'' or ``0X''. The natural or a hexadecimal number preceded by ``0x'' or ``0X''.
The natural
machine integer size is used (i.e., the signed integer type 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. a boolean true.
.Pp .Pp
The character ``#'' begins a comment which terminates at the The character ``#'' begins a comment which terminates at the
end of the line. end of the line.
.Pp .Pp
A statement is either a conditional or an expression. Expression A statement is either a conditional or an expression.
statements are terminated with a new line or ``;''. To continue Expression
statements are terminated with a new line or ``;''.
To continue
an expression on the next line, terminate the first line with ``\\''. an expression on the next line, terminate the first line with ``\\''.
.Ss Conditional Statement .Ss Conditional Statement
The The
@ -400,14 +450,18 @@ Expressions in
.Nm .Nm
are similar to those in the are similar to those in the
C language, with most C operators supported on numeric 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 .Pp
When an expression is used as a statement, its value is discarded 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. effects (assignments and function calls) are useful as statements.
.Pp .Pp
Single valued (no arrays) variables are supported, of both Single valued (no arrays) variables are supported, of both
numeric and string values. Some variables are predefined. They numeric and string values.
Some variables are predefined.
They
are listed below. are listed below.
.Pp .Pp
The operators in order of increasing precedence: The operators in order of increasing precedence:
@ -417,7 +471,8 @@ The operators in order of increasing precedence:
.Ic = .Ic =
.Aq Va expr2 .Aq Va expr2
.Xc .Xc
Assignment. The variable of name Assignment.
The variable of name
.Aq Va expr1 , .Aq Va expr1 ,
which must be string valued, which must be string valued,
is assigned the result of is assigned the result of
@ -438,7 +493,8 @@ if
evaluates true evaluates true
(non-zero numeric value); returns the value of (non-zero numeric value); returns the value of
.Aq Va expr3 .Aq Va expr3
otherwise. Only otherwise.
Only
one of one of
.Aq Va expr2 .Aq Va expr2
and and
@ -452,7 +508,9 @@ be numeric.
.Ic \&|\&| .Ic \&|\&|
.Aq Va expr2 .Aq Va expr2
.Xc .Xc
Logical or. Numeric values only. Short circuit evaluation is supported Logical or.
Numeric values only.
Short circuit evaluation is supported
(i.e., if (i.e., if
.Aq Va expr1 .Aq Va expr1
evaluates true, then evaluates true, then
@ -463,25 +521,29 @@ is not evaluated).
.Ic \&&\&& .Ic \&&\&&
.Aq Va expr2 .Aq Va expr2
.Xc .Xc
Logical and with short circuit evaluation. Numeric values only. Logical and with short circuit evaluation.
Numeric values only.
.It Xo .It Xo
.Aq Va expr1 .Aq Va expr1
.Ic \&| .Ic \&|
.Aq Va expr2 .Aq Va expr2
.Xc .Xc
Bitwise or. Numeric values only. Bitwise or.
Numeric values only.
.It Xo .It Xo
.Aq Va expr1 .Aq Va expr1
.Ic ^ .Ic ^
.Aq Va expr2 .Aq Va expr2
.Xc .Xc
Bitwise exclusive or. Numeric values only. Bitwise exclusive or.
Numeric values only.
.It Xo .It Xo
.Aq Va expr1 .Aq Va expr1
.Ic \&& .Ic \&&
.Aq Va expr2 .Aq Va expr2
.Xc .Xc
Bitwise and. Numeric values only. Bitwise and.
Numeric values only.
.It Xo .It Xo
.Aq Va expr1 .Aq Va expr1
.Ic == .Ic ==
@ -490,9 +552,12 @@ Bitwise and. Numeric values only.
.Ic != .Ic !=
.Aq expr2 .Aq expr2
.Xc .Xc
Comparison (equal and not equal, respectively). The boolean Comparison (equal and not equal, respectively).
result (either 1 or 0) of the comparison is returned. The The boolean
operands can be numeric or string valued. One string operand 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. forces the other to be converted to a string in necessary.
.It Xo .It Xo
.Aq Va expr1 .Aq Va expr1
@ -506,7 +571,8 @@ forces the other to be converted to a string in necessary.
.Aq Va expr2 , .Aq Va expr2 ,
.Xc .Xc
Less than, greater than, less than or equal to, Less than, greater than, less than or equal to,
greater than or equal to. Both numeric and string values, with greater than or equal to.
Both numeric and string values, with
automatic conversion as above. automatic conversion as above.
.It Xo .It Xo
.Aq Va expr1 .Aq Va expr1
@ -521,7 +587,8 @@ If both operands are numbers,
is bit is bit
shifted left (or right) by shifted left (or right) by
.Aq Va expr2 .Aq Va expr2
bits. If bits.
If
.Aq Va expr1 .Aq Va expr1
is is
a string, then its first (or last) a string, then its first (or last)
@ -539,7 +606,8 @@ in place of its value).
.Ic - .Ic -
.Aq Va expr2 .Aq Va expr2
.Xc .Xc
Addition and subtraction on numbers. For ``+'', if one Addition and subtraction on numbers.
For ``+'', if one
argument is a string, then the other is converted to a string, argument is a string, then the other is converted to a string,
and the result is the concatenation of the two strings. and the result is the concatenation of the two strings.
.It Xo .It Xo
@ -553,7 +621,8 @@ and the result is the concatenation of the two strings.
.Ic \&% .Ic \&%
.Aq Va expr2 .Aq Va expr2
.Xc .Xc
Multiplication, division, modulo. Numbers only. Multiplication, division, modulo.
Numbers only.
.It Xo .It Xo
.Ic \- Ns Aq Va expr , .Ic \- Ns Aq Va expr ,
.Ic ~ Ns Aq Va expr , .Ic ~ Ns Aq Va expr ,
@ -562,16 +631,19 @@ Multiplication, division, modulo. Numbers only.
.Ic \&$? Ns Aq Va expr .Ic \&$? Ns Aq Va expr
.Xc .Xc
The first three are unary minus, bitwise complement and logical complement The first three are unary minus, bitwise complement and logical complement
on numbers only. The operator, ``$'', takes on numbers only.
The operator, ``$'', takes
.Aq Va expr .Aq Va expr
and returns and returns
the value of the variable of that name. If the value of the variable of that name.
If
.Aq Va expr .Aq Va expr
is numeric is numeric
with value with value
.Ar n .Ar n
and it appears within an alias macro (see below), and it appears within an alias macro (see below),
then it refers to the nth argument of the alias invocation. ``$?'' then it refers to the nth argument of the alias invocation.
``$?''
tests for the existence of the variable tests for the existence of the variable
.Aq Va expr , .Aq Va expr ,
and returns 1 and returns 1
@ -585,7 +657,8 @@ must be a string that is the unique
prefix of the name of a builtin prefix of the name of a builtin
.Nm .Nm
function function
or the full name of a user defined alias macro. In the case of a builtin or the full name of a user defined alias macro.
In the case of a builtin
function, function,
.Aq Ar arglist .Aq Ar arglist
can be in one of two forms: can be in one of two forms:
@ -595,28 +668,36 @@ argname1 = <expr1>, argname2 = <expr2>, ...
.Ed .Ed
.Pp .Pp
The two forms can in fact be intermixed, but the result is The two forms can in fact be intermixed, but the result is
unpredictable. Most arguments can be omitted; default values will unpredictable.
be supplied for them. The Most arguments can be omitted; default values will
be supplied for them.
The
.Ar argnames .Ar argnames
can be unique prefixes 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. arguments are used only to disambiguate, and can usually be omitted.
.Pp .Pp
Only the first argument form is valid for user defined aliases. Aliases Only the first argument form is valid for user defined aliases.
Aliases
are defined using the are defined using the
.Ic alias .Ic alias
builtin function (see below). Arguments builtin function (see below).
Arguments
are accessed via a variant of the variable mechanism (see ``$'' operator are accessed via a variant of the variable mechanism (see ``$'' operator
above). above).
.Pp .Pp
Most functions return value, but some are used for side effect 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 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 .El
.Ss Builtin Functions .Ss Builtin Functions
The arguments are listed by name in their natural 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 . .Sq Op .
Arguments Arguments
that have no names are in angle brackets that have no names are in angle brackets
@ -640,14 +721,16 @@ in which case a non-zero value is true.
.Bq Aq Ar string\-list .Bq Aq Ar string\-list
.Pc .Pc
If no argument is given, all currently defined alias macros are If no argument is given, all currently defined alias macros are
listed. Otherwise, listed.
Otherwise,
.Aq Ar string .Aq Ar string
is defined as an alias, is defined as an alias,
with expansion with expansion
.Aq Ar string\-list > . .Aq Ar string\-list > .
The previous definition of The previous definition of
.Aq Ar string , .Aq Ar string ,
if any, is returned. Default for if any, is returned.
Default for
.Aq Ar string\-list .Aq Ar string\-list
is no change. is no change.
.It Ic close Ns Pq Aq Ar window\-list .It Ic close Ns Pq Aq Ar window\-list
@ -657,7 +740,8 @@ If
.Aq Ar window\-list .Aq Ar window\-list
is the word is the word
.Ar all , .Ar all ,
than all windows are closed. No value is returned. than all windows are closed.
No value is returned.
.It Ic cursormodes Ns Pq Bq Ar modes .It Ic cursormodes Ns Pq Bq Ar modes
Set the window cursor to Set the window cursor to
.Ar modes . .Ar modes .
@ -672,8 +756,10 @@ or of the mode bits defined as the variables
(blinking), (blinking),
and and
.Ar m_grp .Ar m_grp
(graphics, terminal dependent). Return (graphics, terminal dependent).
value is the previous modes. Default is no change. Return
value is the previous modes.
Default is no change.
For example, For example,
.Li cursor($m_rev$m_blk) .Li cursor($m_rev$m_blk)
sets the window cursors to blinking sets the window cursors to blinking
@ -682,14 +768,19 @@ reverse video.
Set the default buffer size to Set the default buffer size to
.Ar nline . .Ar nline .
Initially, it is Initially, it is
48 lines. Returns the old default buffer size. Default is 48 lines.
no change. Using a very large buffer can slow the program down Returns the old default buffer size.
Default is
no change.
Using a very large buffer can slow the program down
considerably. considerably.
.It Ic default_shell Ns Pq Bq Aq Ar string\-list .It Ic default_shell Ns Pq Bq Aq Ar string\-list
Set the default window shell program to Set the default window shell program to
.Aq Ar string\-list . .Aq Ar string\-list .
Returns Returns
the first string in the old shell setting. Default is no change. Initially, the first string in the old shell setting.
Default is no change.
Initially,
the default shell is taken from the environment variable the default shell is taken from the environment variable
.Ev SHELL . .Ev SHELL .
.It Ic default_smooth Ns Pq Bq Ar flag .It Ic default_smooth Ns Pq Bq Ar flag
@ -698,7 +789,8 @@ Set the default value of the
argument argument
to the command to the command
.Nm .Nm
(see below). The argument (see below).
The argument
is a boolean flag (one of is a boolean flag (one of
.Ar on , .Ar on ,
.Ar off , .Ar off ,
@ -707,7 +799,8 @@ is a boolean flag (one of
.Ar true , .Ar true ,
.Ar false , .Ar false ,
or a number, 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 old value (as a number) is returned.
The initial value is 1 (true). The initial value is 1 (true).
.It Xo .It Xo
@ -719,17 +812,21 @@ Write the list of strings,
to to
.Nm , .Nm ,
separated 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 displayed in the window, the processes in the window are not
involved (see involved (see
.Ic write .Ic write
below). No value is returned. Default below).
No value is returned.
Default
is the current window. is the current window.
.It Ic escape Ns Pq Bq Ar escapec .It Ic escape Ns Pq Bq Ar escapec
Set the escape character to Set the escape character to
.Ar escape-char . .Ar escape-char .
Returns the old Returns the old
escape character as a one-character string. Default is no escape character as a one-character string.
Default is no
change. change.
.Ar Escapec .Ar Escapec
can be a string of a single character, or can be a string of a single character, or
@ -745,8 +842,10 @@ Move
.Nm .Nm
in or out of foreground. in or out of foreground.
.Ar Flag .Ar Flag
is a boolean value. The old foreground flag is a boolean value.
is returned. Default for The old foreground flag
is returned.
Default for
.Nm .Nm
is the current window, is the current window,
default for default for
@ -761,21 +860,27 @@ Set the label of
to to
.Ar label . .Ar label .
Returns the old Returns the old
label as a string. Default for label as a string.
Default for
.Nm .Nm
is the current is the current
window, default for window, default for
.Ar label .Ar label
is no change. To turn is no change.
To turn
off a label, set it to an empty string (""). off a label, set it to an empty string ("").
.It Ic list Ns Pq .It Ic list Ns Pq
No arguments. List the identifiers and labels of all windows. No No arguments.
List the identifiers and labels of all windows.
No
value is returned. value is returned.
.It Ic select Ns Pq Bq Ar window .It Ic select Ns Pq Bq Ar window
Make Make
.Nm .Nm
the current window. The previous current window the current window.
is returned. Default is no change. The previous current window
is returned.
Default is no change.
.It Ic source Ns Pq Ar filename .It Ic source Ns Pq Ar filename
Read and execute the long commands in Read and execute the long commands in
.Ar filename . .Ar filename .
@ -790,7 +895,8 @@ sounding the terminal's bell.
can take on the same can take on the same
values as in values as in
.Ar foreground .Ar foreground
above. Returns the old terse flag. above.
Returns the old terse flag.
Default is no change. Default is no change.
.It Ic unalias Ns Pq Ar alias .It Ic unalias Ns Pq Ar alias
Undefine Undefine
@ -807,7 +913,9 @@ Returns -1 if
does not exist, does not exist,
0 otherwise. 0 otherwise.
.It Ic variables Ns Pq .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 .It Xo
.Ic window Ns ( Bq Ar row , .Ic window Ns ( Bq Ar row ,
.Bq Ar column , .Bq Ar column ,
@ -831,8 +939,10 @@ and size
If If
.Ar nline .Ar nline
is specified, is specified,
then that many lines are allocated for the text buffer. Otherwise, then that many lines are allocated for the text buffer.
the default buffer size is used. Default values for Otherwise,
the default buffer size is used.
Default values for
.Ar row , .Ar row ,
.Ar column , .Ar column ,
.Ar nrow , .Ar nrow ,
@ -856,10 +966,12 @@ allocate pseudo-terminal for this window rather than socketpair (default
true), and map new line characters in this window to carriage return true), and map new line characters in this window to carriage return
and line feed (default true if socketpair is used, false otherwise). and line feed (default true if socketpair is used, false otherwise).
Normally, a window is automatically closed when its process Normally, a window is automatically closed when its process
exits. Setting exits.
Setting
.Ar keepopen .Ar keepopen
to true (default false) prevents this to true (default false) prevents this
action. When action.
When
.Ar smooth .Ar smooth
is true, the screen is updated more frequently is true, the screen is updated more frequently
(for this window) to produce a more terminal-like behavior. (for this window) to produce a more terminal-like behavior.
@ -873,7 +985,8 @@ is a list of strings that will be used as the shell
program to place in the window (default is the program specified program to place in the window (default is the program specified
by by
.Ar default_shell , .Ar default_shell ,
see above). The created window's identifier see above).
The created window's identifier
is returned as a number. is returned as a number.
.It Xo .It Xo
.Ic write Ns ( Bq Ar window , .Ic write Ns ( Bq Ar window ,
@ -884,12 +997,16 @@ Send the list of strings,
to to
.Nm , .Nm ,
separated separated
by spaces but not terminated with a new line. The strings are actually by spaces but not terminated with a new line.
given to the window as input. No value is returned. Default The strings are actually
given to the window as input.
No value is returned.
Default
is the current window. is the current window.
.El .El
.Ss Predefined Variables .Ss Predefined Variables
These variables are for information only. Redefining them does These variables are for information only.
Redefining them does
not affect the internal operation of not affect the internal operation of
.Nm . .Nm .
.Bl -tag -width modes .Bl -tag -width modes
@ -897,7 +1014,8 @@ not affect the internal operation of
The baud rate as a number between 50 and 38400. The baud rate as a number between 50 and 38400.
.It Ar modes .It Ar modes
The display modes (reverse video, underline, blinking, graphics) 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 .Ar modes
is the bitwise or of some of the one bit values, is the bitwise or of some of the one bit values,
.Ar m_blk , .Ar m_blk ,
@ -923,7 +1041,8 @@ The number of columns on the physical screen.
.It Ar nrow .It Ar nrow
The number of rows on the physical screen. The number of rows on the physical screen.
.It Ar term .It Ar term
The terminal type. The standard name, found in the second name The terminal type.
The standard name, found in the second name
field of the terminal's field of the terminal's
.Ev TERMCAP .Ev TERMCAP
entry, is used. entry, is used.

View File

@ -237,7 +237,8 @@ exits abnormally.
.Pp .Pp
File flags cannot be set by File flags cannot be set by
.Xr fchflags 2 .Xr fchflags 2
over a NFS file system. Other file systems do not have a concept of flags. over a NFS file system.
Other file systems do not have a concept of flags.
The The
.Nm .Nm
utility will only warn when flags could not be set on a file system utility will only warn when flags could not be set on a file system

View File

@ -104,7 +104,8 @@ The default prefix is the string
.It Fl r .It Fl r
Cause Cause
.Nm .Nm
to produce separate files for code and tables. The code file to produce separate files for code and tables.
The code file
is named is named
.Pa y.code.c , .Pa y.code.c ,
and the tables file is named and the tables file is named

View File

@ -73,13 +73,15 @@ to their corresponding map names.
.It Fl m Op Ar mname .It Fl m Op Ar mname
Find the master Find the master
.Tn YP .Tn YP
server for the named map. No server for the named map.
No
.Ar host .Ar host
may be specified with the may be specified with the
.Fl m .Fl m
option. option.
.Ar Mname .Ar Mname
can be a map name or nickname. If can be a map name or nickname.
If
.Ar mname .Ar mname
is omitted, is omitted,
.Nm .Nm