Fix various lint warnings in manuals

Fix "new sentence, new line" warnings throughout so that formatters
can produce correct spacing between sentences.

join.1
  Remove unnecessary Ns macros. These are not necessary for delimeters,
  which get special treatment.

xinstall.1
  Fix date in manual. The contents were last modified on 2016-12-03,
  so use that instead of the invalid date.

grep.1
  Fix escape sequence for `\<` and `\>`.

ed.1
  Remove spurious `\\n` escape for the null-command.
This commit is contained in:
Michael Forney 2020-03-01 14:37:31 -08:00
parent dbbac61fc4
commit 22921a859f
44 changed files with 381 additions and 270 deletions

10
cal.1
View File

@ -27,18 +27,20 @@ year to stdout.
The date formatting is according to The date formatting is according to
.Xr localtime 3 . .Xr localtime 3 .
.Pp .Pp
The Julian calendar is used until Sep 2, 1752. The Gregorian calendar is used The Julian calendar is used until Sep 2, 1752.
starting the next day on Sep 14, 1752. The Gregorian calendar is used starting the next day on Sep 14, 1752.
.Sh OPTIONS .Sh OPTIONS
.Bl -tag -width Ds .Bl -tag -width Ds
.It Fl 1 .It Fl 1
Print current month. This is the default. Print current month.
This is the default.
.It Fl 3 .It Fl 3
Print previous, current and next month. Print previous, current and next month.
.It Fl c Ar num .It Fl c Ar num
Print Print
.Ar num .Ar num
calendars in a row. The default is 3. calendars in a row.
The default is 3.
.It Fl f Ar num .It Fl f Ar num
Set Set
.Ar num .Ar num

3
cat.1
View File

@ -12,7 +12,8 @@
.Nm .Nm
reads each reads each
.Ar file .Ar file
in sequence and writes it to stdout. If no in sequence and writes it to stdout.
If no
.Ar file .Ar file
is given is given
.Nm .Nm

View File

@ -34,7 +34,8 @@ if it is a symbolic link.
.It Fl L .It Fl L
Dereference all symbolic links. Dereference all symbolic links.
.It Fl P .It Fl P
Preserve symbolic links. This is the default. Preserve symbolic links.
This is the default.
.El .El
.Sh SEE ALSO .Sh SEE ALSO
.Xr chmod 1 , .Xr chmod 1 ,

View File

@ -69,7 +69,8 @@ if it is a symbolic link.
.It Fl L .It Fl L
Dereference all symbolic links. Dereference all symbolic links.
.It Fl P .It Fl P
Preserve symbolic links. This is the default. Preserve symbolic links.
This is the default.
.El .El
.Sh SEE ALSO .Sh SEE ALSO
.Xr chgrp 1 , .Xr chgrp 1 ,

View File

@ -45,7 +45,8 @@ if it is a symbolic link.
.It Fl L .It Fl L
Dereference all symbolic links. Dereference all symbolic links.
.It Fl P .It Fl P
Preserve symbolic links. This is the default. Preserve symbolic links.
This is the default.
.El .El
.Sh SEE ALSO .Sh SEE ALSO
.Xr chmod 1 , .Xr chmod 1 ,

3
cmp.1
View File

@ -14,7 +14,8 @@ compares
.Ar file1 .Ar file1
and and
.Ar file2 .Ar file2
byte by byte. If they differ, byte by byte.
If they differ,
.Nm .Nm
writes the first differing byte- and line-number to stdout. writes the first differing byte- and line-number to stdout.
.Sh OPTIONS .Sh OPTIONS

4
cols.1
View File

@ -24,8 +24,8 @@ reads from stdin.
.Pp .Pp
By default By default
.Nm cols .Nm cols
tries to figure out the width of the output tries to figure out the width of the output device.
device. If that fails, it defaults to 65 chars. If that fails, it defaults to 65 chars.
.Sh OPTIONS .Sh OPTIONS
.Bl -tag -width Ds .Bl -tag -width Ds
.It Fl c Ar num .It Fl c Ar num

7
cp.1
View File

@ -27,7 +27,8 @@ has to be a directory.
.Sh OPTIONS .Sh OPTIONS
.Bl -tag -width Ds .Bl -tag -width Ds
.It Fl a .It Fl a
Preserve block devices, character devices, sockets and FIFOs. Implies Preserve block devices, character devices, sockets and FIFOs.
Implies
.Fl p , .Fl p ,
.Fl P .Fl P
and and
@ -55,8 +56,8 @@ Preserve symbolic links.
This is the default with This is the default with
.Fl R . .Fl R .
.It Fl R .It Fl R
Traverse directories recursively. If this flag is not specified, directories Traverse directories recursively.
are not copied. If this flag is not specified, directories are not copied.
.El .El
.Sh SEE ALSO .Sh SEE ALSO
.Xr mv 1 .Xr mv 1

18
cut.1
View File

@ -33,9 +33,10 @@ reads from stdin.
.Pp .Pp
.Ar list .Ar list
is a comma or space separated list of numbers and ranges starting is a comma or space separated list of numbers and ranges starting
from 1. Ranges have the form 'N-M'. If N or M is missing, from 1.
beginning or end of line is assumed. Numbers and ranges Ranges have the form 'N-M'. If N or M is missing, beginning or end
may be repeated, overlapping and in any order. of line is assumed.
Numbers and ranges may be repeated, overlapping and in any order.
.Pp .Pp
Selected input is written in the same order it is read Selected input is written in the same order it is read
and is written exactly once. and is written exactly once.
@ -47,16 +48,17 @@ specifies byte | character positions.
.It Fl d Ar delim .It Fl d Ar delim
Use Use
.Ar delim .Ar delim
as field delimiter, which can be an arbitrary string. Default is '\et'. as field delimiter, which can be an arbitrary string.
Default is '\et'.
.It Fl f Ar list .It Fl f Ar list
.Ar list .Ar list
specifies field numbers. Lines not containing field specifies field numbers.
delimiters are passed through, unless Lines not containing field delimiters are passed through, unless
.Fl s .Fl s
is specified. is specified.
.It Fl n .It Fl n
Do not split multibyte characters. A character is written when its Do not split multibyte characters.
last byte is selected. A character is written when its last byte is selected.
.It Fl s .It Fl s
Suppress lines not containing field delimiters. Suppress lines not containing field delimiters.
.El .El

10
date.1
View File

@ -41,8 +41,8 @@ sign signals a user-defined format string using
conversion specifications. conversion specifications.
.Pp .Pp
An operand without a leading plus sign is interpreted as a value An operand without a leading plus sign is interpreted as a value
for setting the system's current date and time. The canonical for setting the system's current date and time.
representation for setting the date and time is: The canonical representation for setting the date and time is:
.Pp .Pp
.Bl -tag -width Ds -compact -offset indent .Bl -tag -width Ds -compact -offset indent
.It Ar mm .It Ar mm
@ -65,12 +65,14 @@ is not, a value for
.Ar yy .Ar yy
between 69 and 99 results in a between 69 and 99 results in a
.Ar CC .Ar CC
value of 19. Otherwise, a value of 19.
Otherwise, a
.Ar CC .Ar CC
value of 20 is used. value of 20 is used.
.El .El
.Pp .Pp
The century and year are optional. The default is the current year. The century and year are optional.
The default is the current year.
.Sh STANDARDS .Sh STANDARDS
The The
.Nm .Nm

6
du.1
View File

@ -18,7 +18,8 @@
displays the file system block usage for each displays the file system block usage for each
.Ar file .Ar file
argument and for each directory in the file hierarchy rooted in directory argument and for each directory in the file hierarchy rooted in directory
argument. If no argument.
If no
.Ar file .Ar file
is specified, the block usage of the hierarchy rooted in the current directory is specified, the block usage of the hierarchy rooted in the current directory
is displayed. is displayed.
@ -43,7 +44,8 @@ recursively traversing directories.
.It Fl L .It Fl L
Always dereference symbolic links while recursively traversing directories. Always dereference symbolic links while recursively traversing directories.
.It Fl P .It Fl P
Don't dereference symbolic links. This is the default. Don't dereference symbolic links.
This is the default.
.It Fl x .It Fl x
Do not traverse file systems mount points. Do not traverse file systems mount points.
.El .El

180
ed.1
View File

@ -11,15 +11,17 @@
.Op Ar file .Op Ar file
.Sh DESCRIPTION .Sh DESCRIPTION
.Nm .Nm
is the standard text editor. It performs line-oriented operations on a buffer; is the standard text editor.
The buffer's contents are manipulated in command mode and text is written to the It performs line-oriented operations on a buffer; The buffer's contents are
buffer in input mode. Command mode is the default. To exit input mode enter a manipulated in command mode and text is written to the buffer in input mode.
dot ('.') on a line of its own. Command mode is the default.
To exit input mode enter a dot ('.') on a line of its own.
.Pp .Pp
If If
.Nm .Nm
is invoked with a file as an argument, it will simulate an edit command and read is invoked with a file as an argument, it will simulate an edit command and read
the file's contents into a buffer. Changes to this buffer are local to the file's contents into a buffer.
Changes to this buffer are local to
.Nm .Nm
until a write command is given. until a write command is given.
.Pp .Pp
@ -37,10 +39,11 @@ as a prompt when in command mode
.El .El
.Sh EXTENDED DESCRIPTION .Sh EXTENDED DESCRIPTION
.Ss Addresses .Ss Addresses
Commands operate on addresses. Addresses are used to refer to lines Commands operate on addresses.
within the buffer. Address ranges may have spaces before and after the separator. Addresses are used to refer to lines within the buffer.
Unless otherwise specified, 0 is an invalid address. The following symbols are Address ranges may have spaces before and after the separator.
valid addresses: Unless otherwise specified, 0 is an invalid address.
The following symbols are valid addresses:
.Bl -tag -width Ds .Bl -tag -width Ds
.It n .It n
The nth line. The nth line.
@ -57,11 +60,11 @@ The previous line.
.It ^n or -n .It ^n or -n
The nth previous line. The nth previous line.
.It x,y .It x,y
The range of lines from x to y. The default value of x is 1, and the default The range of lines from x to y.
value of y is $. The default value of x is 1, and the default value of y is $.
.It x;y .It x;y
As above, except that the current line is set to x. Omitting x in this case uses As above, except that the current line is set to x.
the current line as the default value. Omitting x in this case uses the current line as the default value.
.It /re/ .It /re/
The next line matching re. The next line matching re.
.It ?re? .It ?re?
@ -69,82 +72,94 @@ The last line matching re.
.It 'c .It 'c
The line marked by c. See k below. The line marked by c. See k below.
.El .El
.Ss Commands. .Ss Commands
.Nm .Nm
expects to see one command per line, with the following exception: commands may expects to see one command per line, with the following exception: commands may
be suffixed with either a list, number, or print command. These suffixed be suffixed with either a list, number, or print command.
commands are run after the command they're suffixed to has executed. These suffixed commands are run after the command they're suffixed to has
executed.
.Pp .Pp
The following is the list of commands that The following is the list of commands that
.Nm .Nm
knows about. The parentheses contain the default addresses that a command uses. knows about.
The parentheses contain the default addresses that a command uses.
.Bl -tag -width Ds .Bl -tag -width Ds
.It (.)a .It (.)a
Append text after the addressed line. The dot is set to the last line Append text after the addressed line.
entered. If no text was entered, the dot is set to the addressed line. An The dot is set to the last line entered.
address of 0 appends to the start of the buffer. If no text was entered, the dot is set to the addressed line.
An address of 0 appends to the start of the buffer.
.It (.,.)c .It (.,.)c
Delete the addressed lines and then accept input to replace them. The dot Delete the addressed lines and then accept input to replace them.
is set to the last line entered. If no text was entered, the dot is set to The dot is set to the last line entered.
the line before the deleted lines. If no text was entered, the dot is set to the line before the deleted lines.
.It (.,.)d .It (.,.)d
Delete the addressed lines. If there is a line after the deleted range, the Delete the addressed lines.
dot is set to it. Otherwise, the dot is set to the line before the deleted range. If there is a line after the deleted range, the dot is set to it.
Otherwise, the dot is set to the line before the deleted range.
.It e Ar file .It e Ar file
Delete the contents of the buffer and load in Delete the contents of the buffer and load in
.Ar file .Ar file
for editing, printing the bytes read to standard output. If no filename is for editing, printing the bytes read to standard output.
given, If no filename is given,
.Nm .Nm
uses the currently remembered filename. The remembered filename is set to uses the currently remembered filename.
The remembered filename is set to
.Ar file .Ar file
for later use. for later use.
.It E Ar file .It E Ar file
As above, but without warning if the current buffer has unsaved changes. As above, but without warning if the current buffer has unsaved changes.
.It f Ar file .It f Ar file
Set the currently remembered filename to Set the currently remembered filename to
.Ar .Ar file
file
, or print the currently remembered filename if , or print the currently remembered filename if
.Ar .Ar file
file is omitted. is omitted.
.It (1,$)g/re/command .It (1,$)g/re/command
Apply command to lines matching re. The dot is set to the matching line before Apply command to lines matching re.
command is executed. When each matching line has been operated on, the dot is The dot is set to the matching line before command is executed.
set to the last line operated on. If no lines match then the dot remains When each matching line has been operated on, the dot is set to the last line
unchanged. The command used may not be g, G, v, or V. operated on.
If no lines match then the dot remains unchanged.
The command used may not be g, G, v, or V.
.It (1,$)G/re/ .It (1,$)G/re/
Interactively edit the range of line addresses that match re. The dot is set to Interactively edit the range of line addresses that match re.
the matching line and printed before a command is input. When each matching line The dot is set to the matching line and printed before a command is input.
has been operated on, the dot is set to the last line operated on. If no lines When each matching line has been operated on, the dot is set to the last line
match then the dot remains unchanged. The command used may not be a, c, i, g, operated on.
G, v, or V. If no lines match then the dot remains unchanged.
The command used may not be a, c, i, g, G, v, or V.
.It h .It h
Print the reason for the most recent error. Print the reason for the most recent error.
.It H .It H
Toggle error explanations. If on, the above behaviour is produced on all Toggle error explanations.
subsequent errors. If on, the above behaviour is produced on all subsequent errors.
.It (.)i .It (.)i
Insert text into the buffer before the addressed line. The dot is set to the Insert text into the buffer before the addressed line.
last line entered. If no text was entered, the dot is set to the addressed line The dot is set to the last line entered.
If no text was entered, the dot is set to the addressed line
.It (.,.+1)j .It (.,.+1)j
Join two lines together. If only one address is given, nothing happens. The dot Join two lines together.
is set to the newly joined line. If only one address is given, nothing happens.
The dot is set to the newly joined line.
.It (.)kc .It (.)kc
Mark the line with the lower case character c. The dot is unchanged. Mark the line with the lower case character c. The dot is unchanged.
.It (.,.)l .It (.,.)l
Unambiguously print the addressed lines. The dot is set to the last line written. Unambiguously print the addressed lines.
The dot is set to the last line written.
.It (.,.)m(.) .It (.,.)m(.)
Move lines in the buffer to the line address on the right hand side. An address Move lines in the buffer to the line address on the right hand side.
of 0 on the right hand side moves to the start of the buffer. The dot is set to An address of 0 on the right hand side moves to the start of the buffer.
the last line moved. The dot is set to the last line moved.
.It (.,.)n .It (.,.)n
Print the addressed lines and their numbers. The dot is set to the last line Print the addressed lines and their numbers.
printed. The dot is set to the last line printed.
.It (.,.)p .It (.,.)p
Print the addressed lines. The dot is set to the last line printed. Print the addressed lines.
The dot is set to the last line printed.
.It P .It P
Toggle the prompt. Defaults to off, but is switched on if the -p flag is used. Toggle the prompt.
Defaults to off, but is switched on if the -p flag is used.
.It q .It q
Quit Quit
.Nm .Nm
@ -155,22 +170,25 @@ As above, but without warning if the current buffer has unsaved changes.
Read in Read in
.Ar file .Ar file
and append it to the current buffer, printing the bytes read to standard output. and append it to the current buffer, printing the bytes read to standard output.
The currently remembered filename isn't changed unless it's empty. An address of The currently remembered filename isn't changed unless it's empty.
0 reads the file into the start of the buffer. An address of 0 reads the file into the start of the buffer.
.It (.,.)s/re/replacement/flags .It (.,.)s/re/replacement/flags
Substitute re for replacement in lines matching re. An & within replacement is Substitute re for replacement in lines matching re.
replaced with the whole string matched by re. Backrefs can be used with the form An & within replacement is replaced with the whole string matched by re.
\\n, where n is a positive non-zero integer. When % is the only character in Backrefs can be used with the form \\n, where n is a positive non-zero integer.
replacement, it is substituted for the replacement string from the last When % is the only character in replacement, it is substituted for the
substitute command. If a newline is part of replacement then the matched string replacement string from the last substitute command.
is split into two lines; this cannot be done as part of a g or v command. If If a newline is part of replacement then the matched string is split into two
flags contains an integer n, then the nth match is replaced. If flags contains lines; this cannot be done as part of a g or v command.
g, all matches are replaced. The dot is set to the last line matched. If flags contains an integer n, then the nth match is replaced.
If flags contains g, all matches are replaced.
The dot is set to the last line matched.
.It (.,.)t(.) .It (.,.)t(.)
As m, but copying instead of moving. The dot is set to the last line added. As m, but copying instead of moving.
The dot is set to the last line added.
.It u .It u
Undo the last change. The dot is set to whatever it was before the undone Undo the last change.
command was performed. The dot is set to whatever it was before the undone command was performed.
.It (1.$)v/re/command .It (1.$)v/re/command
As with g, but operating on lines that don't match re. As with g, but operating on lines that don't match re.
.It (1.$)V/re/ .It (1.$)V/re/
@ -179,30 +197,36 @@ As with G, but operating on lines that don't match re.
Write the addressed lines to Write the addressed lines to
.Ar file .Ar file
, overwriting its previous contents if the file exists, and print the number of , overwriting its previous contents if the file exists, and print the number of
bytes written. If no filename is given the currently remembered filename will be bytes written.
used instead. The dot is unchanged. If no filename is given the currently remembered filename will be used instead.
The dot is unchanged.
.It (1,$)W Ar file .It (1,$)W Ar file
As above, but instead of overwriting the contents of As above, but instead of overwriting the contents of
.Ar file .Ar file
the addressed lines are appended to the addressed lines are appended to
.Ar file .Ar file
instead. instead.
.It (.+1)\\n .It (.+1)
Print the addressed line. Sets the dot to that line. Print the addressed line.
Sets the dot to that line.
.It ($)= .It ($)=
Print the line number of the addressed line. The dot is unchanged. Print the line number of the addressed line.
The dot is unchanged.
.It & .It &
Repeat the last command. Repeat the last command.
.It ! Ar command .It ! Ar command
Execute Execute
.Ar command .Ar command
using sh. If the first character of using sh.
If the first character of
.Ar command .Ar command
is '!' then it is replaced with the text of the previous command. An unescaped % is '!' then it is replaced with the text of the previous command.
is replaced with the currently remembered filename. ! does not process escape An unescaped % is replaced with the currently remembered filename.
characters. When ! does not process escape characters.
When
.Ar command .Ar command
returns a '!' is printed. The dot is unchanged. returns a '!' is printed.
The dot is unchanged.
.El .El
.Sh SEE ALSO .Sh SEE ALSO
.Xr sed 1 , .Xr sed 1 ,

8
expr.1
View File

@ -22,7 +22,8 @@ Let
be a non-elemental expression and be a non-elemental expression and
.Sy expr1 , .Sy expr1 ,
.Sy expr2 .Sy expr2
arbitrary expressions. Then arbitrary expressions.
Then
.Sy expr .Sy expr
has the recursive form has the recursive form
.Sy expr = [(] expr1 operand expr2 [)]. .Sy expr = [(] expr1 operand expr2 [)].
@ -76,8 +77,9 @@ against
is anchored with an implicit '^'. is anchored with an implicit '^'.
.Pp .Pp
You can't directly match the empty string, since zero matched characters You can't directly match the empty string, since zero matched characters
resolve equally to a failed match. To work around this limitation, use resolve equally to a failed match.
"expr X'' : 'X$' instead of "expr '' : '$'" To work around this limitation, use "expr X'' : 'X$' instead of "expr ''
: '$'"
.El .El
.Sh EXIT STATUS .Sh EXIT STATUS
.Bl -tag -width Ds .Bl -tag -width Ds

57
find.1
View File

@ -26,9 +26,9 @@ Dereference all symbolic links encountered.
.El .El
.Sh EXTENDED DESCRIPTION .Sh EXTENDED DESCRIPTION
.Ar expression .Ar expression
is a combination of the following primaries and boolean operators. In is a combination of the following primaries and boolean operators.
the following descriptions the number n can be replaced by +n, n, or -n, In the following descriptions the number n can be replaced by +n, n, or
to mean more than, exactly, or less than n respectively. -n, to mean more than, exactly, or less than n respectively.
.Ss Primaries .Ss Primaries
.Bl -tag -width Ds .Bl -tag -width Ds
.It Fl name Ar pattern .It Fl name Ar pattern
@ -40,14 +40,18 @@ True if the file belongs to a user for which getpwuid() returns NULL.
.It Fl nogroup .It Fl nogroup
True if the file belongs to a group for which getgrgid() returns NULL. True if the file belongs to a group for which getgrgid() returns NULL.
.It Fl xdev .It Fl xdev
True. Do not enter directory on a different device. True.
Do not enter directory on a different device.
.It Fl prune .It Fl prune
True. Do not enter directory. True.
Do not enter directory.
.It Fl perm Ar mode .It Fl perm Ar mode
True if permissions on the file match mode. Mode is a symbolic mode True if permissions on the file match mode.
as used in chmod. A leading '-' in mode checks that at least all bits Mode is a symbolic mode as used in chmod.
in mode are set in permissions for file. Without the leading '-' the A leading '-' in mode checks that at least all bits in mode are set in
permissions for file must exactly match mode. permissions for file.
Without the leading '-' the permissions for file must exactly match
mode.
.It Fl type Ar t .It Fl type Ar t
True if file is of type specified by True if file is of type specified by
.Ar t . .Ar t .
@ -96,22 +100,27 @@ True if file modified time is
days. days.
.It Fl exec Ar cmd [arg ...] \&; .It Fl exec Ar cmd [arg ...] \&;
Execute cmd with given arguments, replacing each {} in argument list Execute cmd with given arguments, replacing each {} in argument list
with the current file. True if cmd exits with status 0. with the current file.
True if cmd exits with status 0.
.It Fl exec Ar cmd [arg ...] {} + .It Fl exec Ar cmd [arg ...] {} +
True. Add as many files as possible to argument list and execute when True.
the list is full or all files have been found. Add as many files as possible to argument list and execute when the list
is full or all files have been found.
.It Fl ok Ar cmd [arg ...] \&; .It Fl ok Ar cmd [arg ...] \&;
Prompt the user on each file encountered whether or not to execute cmd Prompt the user on each file encountered whether or not to execute cmd
as with -exec. True if the user responds yes and cmd exits with status 0, as with -exec.
false otherwise. True if the user responds yes and cmd exits with status 0, false
otherwise.
.It Fl print .It Fl print
True. Print the path to the current file. True.
Print the path to the current file.
.It Fl newer Ar file .It Fl newer Ar file
True if the modification time of the current file is newer than that of True if the modification time of the current file is newer than that of
the provided file. the provided file.
.It Fl depth .It Fl depth
True. Causes find to evaluate files within in a directory before the True.
directory itself. Causes find to evaluate files within in a directory before the directory
itself.
.El .El
.Ss Operators .Ss Operators
In order of decreasing precedence In order of decreasing precedence
@ -121,15 +130,15 @@ True if expression is true.
.It Ar \&! expression .It Ar \&! expression
True if expression if false. True if expression if false.
.It Ar expression [ Fl a ] Ar expression .It Ar expression [ Fl a ] Ar expression
True if both expressions are true. Second expression is not evaluated True if both expressions are true.
if first expression is false. Second expression is not evaluated if first expression is false.
.Fl a .Fl a
is implied if there is no operator between primaries. is implied if there is no operator between primaries.
.It Ar expression Fl o Ar expression .It Ar expression Fl o Ar expression
True if either expression is true. Second expression is not evaluated True if either expression is true.
if first expression is true. Second expression is not evaluated if first expression is true.
.El .El
.Pp .Pp
If no expression is supplied, -print is used. If an expression is supplied If no expression is supplied, -print is used.
but none of -print, -exec, or -ok is supplied, then -a -print is appended If an expression is supplied but none of -print, -exec, or -ok is
to the expressions. supplied, then -a -print is appended to the expressions.

13
flock.1
View File

@ -11,15 +11,17 @@
.Ar cmd Op arg ... .Ar cmd Op arg ...
.Sh DESCRIPTION .Sh DESCRIPTION
.Nm .Nm
is used to manage advisory locks on open files. It is commonly used to prevent is used to manage advisory locks on open files.
long running cron jobs from running in parallel. If It is commonly used to prevent long running cron jobs from running in
parallel.
If
.Ar file .Ar file
does not exist, it will be created. does not exist, it will be created.
.Sh OPTIONS .Sh OPTIONS
.Bl -tag -width Ds .Bl -tag -width Ds
.It Fl n .It Fl n
Set non-blocking mode on the lock. Fail immediately if the lock Set non-blocking mode on the lock.
cannot be acquired. Fail immediately if the lock cannot be acquired.
.It Fl o .It Fl o
Close the file descriptor before exec to avoid having the exec'ed Close the file descriptor before exec to avoid having the exec'ed
program holding on to the lock. program holding on to the lock.
@ -28,5 +30,6 @@ Acquire a shared lock.
.It Fl u .It Fl u
Release the lock. Release the lock.
.It Fl x .It Fl x
Acquire an exclusive lock. This is the default. Acquire an exclusive lock.
This is the default.
.El .El

3
fold.1
View File

@ -28,7 +28,8 @@ at the last space within width.
.It Fl w Ar num | Fl Ns Ar num .It Fl w Ar num | Fl Ns Ar num
Break at Break at
.Ar num .Ar num
characters. The default is 80. characters.
The default is 80.
.El .El
.Sh STANDARDS .Sh STANDARDS
The The

21
grep.1
View File

@ -17,7 +17,8 @@ searches the input files for lines that match the
.Ar pattern , .Ar pattern ,
a regular expression as defined in a regular expression as defined in
.Xr regex 7 . .Xr regex 7 .
By default each matching line is printed to stdout. If no By default each matching line is printed to stdout.
If no
.Ar file .Ar file
is given is given
.Nm .Nm
@ -27,11 +28,12 @@ reads from stdin.
.It Fl E .It Fl E
Match using extended regex. Match using extended regex.
.It Fl F .It Fl F
Match using fixed strings. Treat each pattern specified as a string instead of Match using fixed strings.
a regular expression. Treat each pattern specified as a string instead of a regular
expression.
.It Fl H .It Fl H
Prefix each matching line with its filename in the output. This is the Prefix each matching line with its filename in the output.
default when there is more than one file specified. This is the default when there is more than one file specified.
.It Fl c .It Fl c
Print only a count of matching lines. Print only a count of matching lines.
.It Fl e Ar pattern .It Fl e Ar pattern
@ -41,9 +43,10 @@ This option is most useful when multiple -e options are used to
specify multiple patterns, or when a pattern begins with a dash. specify multiple patterns, or when a pattern begins with a dash.
.It Fl f Ar file .It Fl f Ar file
Read one or more patterns from the file named by the pathname file. Read one or more patterns from the file named by the pathname file.
Patterns in file shall be terminated by a <newline>. A null pattern can be Patterns in file shall be terminated by a <newline>.
specified by an empty line in pattern_file. Unless the -E or -F option is A null pattern can be specified by an empty line in pattern_file.
also specified, each pattern shall be treated as a BRE. Unless the -E or -F option is also specified, each pattern shall be
treated as a BRE.
(`-'). (`-').
.It Fl h .It Fl h
Do not prefix each line with 'filename:' prefix. Do not prefix each line with 'filename:' prefix.
@ -63,7 +66,7 @@ Select lines which do
.Sy not .Sy not
match the pattern. match the pattern.
.It Fl w .It Fl w
The expression is searched for as a word (as if surrounded by '\<' and '\>'). The expression is searched for as a word (as if surrounded by '\\<' and '\\>').
.It Fl x .It Fl x
Consider only input lines that use all characters in the line excluding the Consider only input lines that use all characters in the line excluding the
terminating <newline> to match an entire fixed string or regular expression to terminating <newline> to match an entire fixed string or regular expression to

3
head.1
View File

@ -27,7 +27,8 @@ Display initial
.Ar num .Ar num
| |
.Sy N .Sy N
lines. Default is 10. lines.
Default is 10.
.El .El
.Sh SEE ALSO .Sh SEE ALSO
.Xr tail 1 .Xr tail 1

28
join.1
View File

@ -19,8 +19,8 @@ lines from
.Ar file1 .Ar file1
and and
.Ar file2 .Ar file2
on a matching field. If one of the input files is '-', standard input on a matching field.
is read for that file. If one of the input files is '-', standard input is read for that file.
.Pp .Pp
Files are read sequentially and are assumed to be sorted on the join Files are read sequentially and are assumed to be sorted on the join
field. field.
@ -31,9 +31,9 @@ produce unexpected output.
By default, input lines are matched on the first blank-separated By default, input lines are matched on the first blank-separated
field; output lines are space-separated and consist of the join field field; output lines are space-separated and consist of the join field
followed by the remaining fields from followed by the remaining fields from
.Ar file1 Ns , .Ar file1 ,
then the remaining fields from then the remaining fields from
.Ar file2 Ns . .Ar file2 .
.Sh OPTIONS .Sh OPTIONS
.Bl -tag -width Ds .Bl -tag -width Ds
.It Fl 1 Ar field .It Fl 1 Ar field
@ -50,12 +50,12 @@ Print unpairable lines from file
in addition to normal output. in addition to normal output.
.It Fl e Ar string .It Fl e Ar string
When used with When used with
.Fl o Ns , .Fl o ,
replace empty fields in the output list with replace empty fields in the output list with
.Ar string Ns . .Ar string .
.It Fl o Ar list .It Fl o Ar list
Format output according to the string Format output according to the string
.Ar list Ns . .Ar list .
Each element of Each element of
.Ar list .Ar list
may be either may be either
@ -63,22 +63,24 @@ may be either
or 0 (representing the join field). or 0 (representing the join field).
Elements in Elements in
.Ar list .Ar list
may be separated by blanks or commas. For example, may be separated by blanks or commas.
For example,
.Bd -literal -offset indent .Bd -literal -offset indent
join -o "0 2.1 1.3" join -o "0 2.1 1.3"
.Ed .Ed
.Pp .Pp
would print the join field, the first field of would print the join field, the first field of
.Ar file2 Ns , .Ar file2 ,
then the third field of then the third field of
.Ar file1 Ns . .Ar file1 .
.Pp .Pp
Only paired lines are formatted with the Only paired lines are formatted with the
.Fl o .Fl o
option. Unpairable lines (selected with option.
Unpairable lines (selected with
.Fl a .Fl a
or or
.Fl v Ns ) .Fl v )
are printed raw. are printed raw.
.It Fl t Ar delim .It Fl t Ar delim
Use the arbitrary string Use the arbitrary string
@ -98,7 +100,7 @@ specification with the following exeption:
.Bl -bullet -offset indent .Bl -bullet -offset indent
.It .It
Unpairable lines ignore formatting specified with Unpairable lines ignore formatting specified with
.Fl o Ns . .Fl o .
.El .El
.Pp .Pp
The possibility of specifying multibyte delimiters of arbitrary The possibility of specifying multibyte delimiters of arbitrary

View File

@ -31,7 +31,8 @@ Set the message
.Ar priority .Ar priority
given symbolically as a given symbolically as a
.Dq facility.level .Dq facility.level
pair. The default is pair.
The default is
.Dq user.notice . .Dq user.notice .
.It Fl s .It Fl s
Also log to stderr. Also log to stderr.

7
ls.1
View File

@ -18,8 +18,8 @@
.Op Ar file ... .Op Ar file ...
.Sh DESCRIPTION .Sh DESCRIPTION
.Nm .Nm
lists each given file, and the contents of each given directory. If no files lists each given file, and the contents of each given directory.
are given the current directory is listed. If no files are given the current directory is listed.
.Sh OPTIONS .Sh OPTIONS
.Bl -tag -width Ds .Bl -tag -width Ds
.It Fl A .It Fl A
@ -67,7 +67,8 @@ Append a file type indicator to directories.
.It Fl q .It Fl q
Replace non-printable characters in filenames with '?'. Replace non-printable characters in filenames with '?'.
.It Fl R .It Fl R
List directory content recursively. The List directory content recursively.
The
.Fl 1 .Fl 1
flag is set implicitly. flag is set implicitly.
.It Fl r .It Fl r

View File

@ -19,7 +19,8 @@ if it does not already exist.
.It Fl m .It Fl m
Set the file Set the file
.Ar mode .Ar mode
of newly created directories. See of newly created directories.
See
.Xr chmod 1 . .Xr chmod 1 .
.It Fl p .It Fl p
Also create necessary parent directories and Also create necessary parent directories and

View File

@ -18,7 +18,8 @@ if it does not already exist.
.It Fl m .It Fl m
Set the file Set the file
.Ar mode .Ar mode
of newly created named pipes. See of newly created named pipes.
See
.Xr chmod 1 . .Xr chmod 1 .
.El .El
.Sh SEE ALSO .Sh SEE ALSO

View File

@ -13,7 +13,8 @@
.Nm .Nm
creates a temporary file by generating a unique filename with creates a temporary file by generating a unique filename with
.Ar template , .Ar template ,
which has to have at least six 'X's appended to it. If no which has to have at least six 'X's appended to it.
If no
.Ar template .Ar template
is specified, a default of 'tmp.XXXXXXXXXX' is used and the is specified, a default of 'tmp.XXXXXXXXXX' is used and the
tmpdir set to '/tmp' or, if set, the TMPDIR environment variable. tmpdir set to '/tmp' or, if set, the TMPDIR environment variable.
@ -24,10 +25,11 @@ Create a temporary directory instead of a file.
.It Fl p Ar directory .It Fl p Ar directory
Use the specified Use the specified
.Ar directory .Ar directory
as a prefix when generating the temporary filename. The directory will be as a prefix when generating the temporary filename.
overridden by the user's The directory will be overridden by the user's
.Ev TMPDIR .Ev TMPDIR
environment variable if it is set. This option implies the environment variable if it is set.
This option implies the
.Fl t .Fl t
flag (see below). flag (see below).
.It Fl q .It Fl q
@ -37,9 +39,11 @@ Generate a path rooted in a temporary directory.
.It Fl u .It Fl u
Unlink file before Unlink file 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 option is not encouraged. but still introduces a race condition.
Use of this option is not encouraged.
.El .El
.Sh SEE ALSO .Sh SEE ALSO
.Xr mkdtemp 3 , .Xr mkdtemp 3 ,

15
nl.1
View File

@ -40,7 +40,8 @@ All lines.
.It n .It n
No lines. No lines.
.It t .It t
Only non-empty lines. This is the default. Only non-empty lines.
This is the default.
.It p Ns Ar expr .It p Ns Ar expr
Only lines matching Only lines matching
.Ar expr .Ar expr
@ -50,11 +51,13 @@ according to
.It Fl d Ar delim .It Fl d Ar delim
Set Set
.Ar delim .Ar delim
as the delimiter for logical pages. If as the delimiter for logical pages.
If
.Ar delim .Ar delim
is only one character, is only one character,
.Nm .Nm
appends ":" to it. The default is "\e:". appends ":" to it.
The default is "\e:".
.It Fl i Ar num .It Fl i Ar num
Set the increment between numbered lines to Set the increment between numbered lines to
.Ar num . .Ar num .
@ -70,14 +73,16 @@ to one of:
.It ln .It ln
Left justified. Left justified.
.It rn .It rn
Right justified. This is the default. Right justified.
This is the default.
.It rz .It rz
Right justified with leading zeroes. Right justified with leading zeroes.
.El .El
.It Fl s Ar sep .It Fl s Ar sep
Use Use
.Ar sep .Ar sep
to separate line numbers and lines. The default is "\et". to separate line numbers and lines.
The default is "\et".
.It Fl v Ar num .It Fl v Ar num
Start counting lines from Start counting lines from
.Ar num . .Ar num .

9
od.1
View File

@ -16,7 +16,8 @@
.Nm .Nm
writes an octal dump of each writes an octal dump of each
.Ar file .Ar file
to stdout. If no to stdout.
If no
.Ar file .Ar file
is given is given
.Nm .Nm
@ -27,7 +28,8 @@ reads from stdin.
.Ar addressformat .Ar addressformat
is one of d|o|x|n and sets the address to be is one of d|o|x|n and sets the address to be
either in \fId\fRecimal, \fIo\fRctal, he\fIx\fRadecimal or \fIn\fRot either in \fId\fRecimal, \fIo\fRctal, he\fIx\fRadecimal or \fIn\fRot
printed at all. The default is octal. printed at all.
The default is octal.
.It Fl E | e .It Fl E | e
Force Little Endian Force Little Endian
.Fl ( e ) .Fl ( e )
@ -59,7 +61,8 @@ he\fIx\fRadecimal format, processing the given amount of bytes or the length
of \fIC\fRhar, \fIS\fRhort, \fII\fRnteger or \fIL\fRong. of \fIC\fRhar, \fIS\fRhort, \fII\fRnteger or \fIL\fRong.
The default is octal with 4 bytes. The default is octal with 4 bytes.
.It Fl v .It Fl v
Always set. Write all input data, including duplicate lines. Always set.
Write all input data, including duplicate lines.
.It Fl x .It Fl x
Equivalent to Equivalent to
.Fl t x2 . .Fl t x2 .

View File

@ -11,7 +11,8 @@
.Nm .Nm
prints the entire environment as key=value pairs if no prints the entire environment as key=value pairs if no
.Ar var .Ar var
is given. Otherwise, is given.
Otherwise,
.Nm .Nm
prints only the value of each prints only the value of each
.Ar var .Ar var

3
pwd.1
View File

@ -13,7 +13,8 @@ prints the path of the current working directory.
.Sh OPTIONS .Sh OPTIONS
.Bl -tag -width Ds .Bl -tag -width Ds
.It Fl L .It Fl L
Logical path, uses $PWD. This is the default. Logical path, uses $PWD.
This is the default.
.It Fl P .It Fl P
Physical path, avoids all symlinks. Physical path, avoids all symlinks.
.El .El

6
rev.1
View File

@ -11,9 +11,9 @@
.Nm .Nm
reads each reads each
.Ar file .Ar file
in sequence and writes it to stdout, but in sequence and writes it to stdout, but with all characters in each
with all characters in each line in reverse line in reverse order.
order. If no If no
.Ar file .Ar file
is given is given
.Nm .Nm

73
sed.1
View File

@ -56,46 +56,57 @@ Editing commands take the form
.Ss Addresses .Ss Addresses
Addresses are either blank, a positive decimal integer denoting a line Addresses are either blank, a positive decimal integer denoting a line
number, the character '$' denoting the last line of input, or a regular number, the character '$' denoting the last line of input, or a regular
expression. A command with no addresses matches every line, one address expression.
matches individual lines, and two addresses matches a range of lines A command with no addresses matches every line, one address matches
from the first to the second address inclusive. individual lines, and two addresses matches a range of lines from the
first to the second address inclusive.
.Ss Functions .Ss Functions
.Bl -tag -width Ds .Bl -tag -width Ds
.It Ar a Op Ar text .It Ar a Op Ar text
Append text to output after end of current cycle. Append text to output after end of current cycle.
.It Ar b Op Ar label .It Ar b Op Ar label
Branch to label. If no label is provided branch to end of script. Branch to label.
If no label is provided branch to end of script.
.It Ar c Op Ar text .It Ar c Op Ar text
Change. Delete addressed range and output text after end of current cycle. Change.
Delete addressed range and output text after end of current cycle.
.It Ar d .It Ar d
Delete pattern space and begin next cycle. Delete pattern space and begin next cycle.
.It Ar D .It Ar D
Delete pattern space up to and including first newline and begin new Delete pattern space up to and including first newline and begin new
cycle without reading input. If there is no newline, behave like d. cycle without reading input.
If there is no newline, behave like d.
.It Ar g .It Ar g
Get. Replace the pattern space with the hold space. Get.
Replace the pattern space with the hold space.
.It Ar G .It Ar G
Get. Append a newline and the hold space to the pattern space. Get.
Append a newline and the hold space to the pattern space.
.It Ar h .It Ar h
Hold. Replace the hold space with the pattern space. Hold.
Replace the hold space with the pattern space.
.It Ar H .It Ar H
Hold. Append a newline and the pattern space to the hold space. Hold.
Append a newline and the pattern space to the hold space.
.It Ar i Op Ar text .It Ar i Op Ar text
Insert text in output. Insert text in output.
.It Ar l .It Ar l
List? Write the pattern space replacing known non printing characters with List? Write the pattern space replacing known non printing characters with
backslash escaped versions (\\\\, \\a, \\b, \\f, \\r, \\t, \\v). Print backslash escaped versions (\\\\, \\a, \\b, \\f, \\r, \\t, \\v).
bad UTF-8 sequences as \\ooo where ooo is a three digit octal number. Mark Print bad UTF-8 sequences as \\ooo where ooo is a three digit octal
end of lines with '$'. number.
Mark end of lines with '$'.
.It Ar n .It Ar n
Next. Write pattern space (unless Next.
Write pattern space (unless
.Fl n ) , .Fl n ) ,
read next line into pattern space, and continue current cycle. If there read next line into pattern space, and continue current cycle.
is no next line, quit. If there is no next line, quit.
.It Ar N .It Ar N
Next. Read next line, append newline and next line to pattern space, Next.
and continue cycle. If there is no next line, quit without printing Read next line, append newline and next line to pattern space, and
current pattern space. continue cycle.
If there is no next line, quit without printing current pattern space.
.It Ar p .It Ar p
Print current pattern space. Print current pattern space.
.It Ar P .It Ar P
@ -105,12 +116,14 @@ Quit.
.It Ar r file .It Ar r file
Read file and write contents to output. Read file and write contents to output.
.It Ar s/re/text/flags .It Ar s/re/text/flags
Find occurences of regular expression re in the pattern space and replace Find occurences of regular expression re in the pattern space and
with text. A '&' in text is replaced with the entire match. A \\d where replace with text.
d is a decimal digit 1-9 is replaced with the corresponding match group A '&' in text is replaced with the entire match.
from the regular expression. \\n represents a newline in both the regular A \\d where d is a decimal digit 1-9 is replaced with the corresponding
expression and replacement text. A literal newline in the replacement match group from the regular expression.
text must be preceded by a \\. \\n represents a newline in both the regular expression and replacement
text.
A literal newline in the replacement text must be preceded by a \\.
.Pp .Pp
Flags are Flags are
.Bl -tag -width Ds .Bl -tag -width Ds
@ -118,16 +131,18 @@ Flags are
A positive decimal number denoting which match in the pattern space A positive decimal number denoting which match in the pattern space
to replace. to replace.
.It Ar g .It Ar g
Global. Replace all matches in the pattern space. Global.
Replace all matches in the pattern space.
.It Ar p .It Ar p
Print the pattern if a replacement was made. Print the pattern if a replacement was made.
.It Ar w file .It Ar w file
Write the pattern space to file if a replacement was made. Write the pattern space to file if a replacement was made.
.El .El
.It Ar t Op Ar label .It Ar t Op Ar label
Test. Branch to corresponding labelif a substitution has been made since Test.
the last line was read or last t command was executed. If no label is Branch to corresponding label if a substitution has been made since the
provided branch to end of script. last line was read or last t command was executed.
If no label is provided branch to end of script.
.It Ar w file .It Ar w file
Write pattern space to file. Write pattern space to file.
.It Ar x .It Ar x

3
seq.1
View File

@ -31,7 +31,8 @@ as the output line format according to
.It Fl s Ar sep .It Fl s Ar sep
Print Print
.Ar sep .Ar sep
between output lines. The default is "\en". between output lines.
The default is "\en".
.It Fl w .It Fl w
Print out lines in equal width. Print out lines in equal width.
.El .El

8
sort.1
View File

@ -26,8 +26,9 @@ reads from stdin.
.It Fl C .It Fl C
Check that the concatenation of the given Check that the concatenation of the given
.Ar files .Ar files
is sorted rather than sorting them. In this mode, no output is printed to is sorted rather than sorting them.
stdout, and the exit status indicates the result of the check. In this mode, no output is printed to stdout, and the exit status
indicates the result of the check.
.It Fl b .It Fl b
Skip leading whitespace of columns when sorting. Skip leading whitespace of columns when sorting.
.It Fl c .It Fl c
@ -62,7 +63,8 @@ where
and and
.Sy e .Sy e
are the starting column, starting character in that column, ending column and are the starting column, starting character in that column, ending column and
the ending character of that column respectively. If they are not specified, the ending character of that column respectively.
If they are not specified,
.Sy s .Sy s
refers to the first character of the specified starting column, refers to the first character of the specified starting column,
.Sy E .Sy E

View File

@ -25,11 +25,13 @@ reads from stdin.
.It Fl a .It Fl a
Scan each Scan each
.Ar file .Ar file
entirely. This is the default. entirely.
This is the default.
.It Fl n Ar num .It Fl n Ar num
Print sequences of at least Print sequences of at least
.Ar num .Ar num
characters. The default is 4. characters.
The default is 4.
.It Fl t Ar format .It Fl t Ar format
Prepend each string with its byte offset, with Prepend each string with its byte offset, with
.Ar format .Ar format

4
sync.1
View File

@ -10,8 +10,8 @@
.Nm .Nm
invokes invokes
.Xr sync 2 .Xr sync 2
to flush all unwritten changes to disk. This is to flush all unwritten changes to disk.
usually done before shutting down, rebooting or halting. This is usually done before shutting down, rebooting or halting.
.Sh SEE ALSO .Sh SEE ALSO
.Xr fsync 2 , .Xr fsync 2 ,
.Xr sync 2 .Xr sync 2

10
tail.1
View File

@ -13,7 +13,8 @@
.Nm .Nm
writes the last 10 lines of each writes the last 10 lines of each
.Ar file .Ar file
to stdout. If no to stdout.
If no
.Ar file .Ar file
is given, is given,
.Nm .Nm
@ -23,15 +24,16 @@ reads from stdin.
.It Fl c Ar num | Fl m Ar num | Fl n Ar num | Fl Ns Ar num .It Fl c Ar num | Fl m Ar num | Fl n Ar num | Fl Ns Ar num
Display final Display final
.Ar num .Ar num
bytes | characters | lines | bytes | characters | lines | lines.
lines. If If
.Ar num .Ar num
begins with '+' begins with '+'
it is an offset from the beginning of each it is an offset from the beginning of each
.Ar file . .Ar file .
If If
.Ar num .Ar num
begins with '-' it is as if no sign was given. The default is 10 lines. begins with '-' it is as if no sign was given.
The default is 10 lines.
.It Fl f .It Fl f
If one If one
.Ar file .Ar file

8
tar.1
View File

@ -32,8 +32,8 @@ before beginning.
.It Fl f Ar file .It Fl f Ar file
Set Set
.Ar file .Ar file
as input | output archive instead of stdin | stdout. If '-', as input | output archive instead of stdin | stdout.
stdin | stdout is used. If '-', stdin | stdout is used.
.It Fl m .It Fl m
Do not preserve modification time. Do not preserve modification time.
.It Fl t .It Fl t
@ -43,8 +43,8 @@ Extract archive.
.It Fl h .It Fl h
Always dereference symbolic links while recursively traversing directories. Always dereference symbolic links while recursively traversing directories.
.It Fl J | Fl Z | Fl a | Fl j | Fl z .It Fl J | Fl Z | Fl a | Fl j | Fl z
Use xz | compress | lzma | bzip2 | gzip compression or decompression. These Use xz | compress | lzma | bzip2 | gzip compression or decompression.
utilities must be installed separately. These utilities must be installed separately.
Using these flags is discouraged in favour of the flexibility Using these flags is discouraged in favour of the flexibility
and clarity of pipes: and clarity of pipes:
.Bd -literal -offset indent .Bd -literal -offset indent

15
tftp.1
View File

@ -13,17 +13,20 @@
.Sh DESCRIPTION .Sh DESCRIPTION
.Nm .Nm
is a client that implements the trivial file transfer protocol over is a client that implements the trivial file transfer protocol over
either IPv4 or IPv6 as specified in RFC 1350. It can be used to transfer either IPv4 or IPv6 as specified in RFC 1350.
files to and from remote machines. It can be used to transfer files to and from remote machines.
.Sh OPTIONS .Sh OPTIONS
.Bl -tag -width Ds .Bl -tag -width Ds
.It Fl h Ar host .It Fl h Ar host
Set the remote hostname. Set the remote hostname.
.It Fl p Ar port .It Fl p Ar port
Set the remote port. It defaults to port 69. Set the remote port.
It defaults to port 69.
.It Fl x .It Fl x
Extract a file from the server. This is the default Extract a file from the server.
if no flags are specified. Output goes to stdout. This is the default if no flags are specified.
Output goes to stdout.
.It Fl c .It Fl c
Create a file on the server. Input comes from stdin. Create a file on the server.
Input comes from stdin.
.El .El

View File

@ -13,7 +13,8 @@
.Nm .Nm
sets the access and modification time of each sets the access and modification time of each
.Ar file .Ar file
to the current time of day. If to the current time of day.
If
.Ar file .Ar file
doesn't exist, it is created with default permissions. doesn't exist, it is created with default permissions.
.Sh OPTIONS .Sh OPTIONS

11
tsort.1
View File

@ -9,12 +9,13 @@
.Op Ar file .Op Ar file
.Sh DESCRIPTION .Sh DESCRIPTION
.Nm .Nm
topologically sorts a graph. The graph is read topologically sorts a graph.
either from The graph is read either from
.Ar file .Ar file
or from standard input. The result is not optimized or from standard input.
for any particular usage. Loops are detected and The result is not optimized for any particular usage.
reported to standard error, but does not stop the sort. Loops are detected and reported to standard error, but does not stop the
sort.
.Pp .Pp
The input is a list of edges (vertex pairs), where The input is a list of edges (vertex pairs), where
the edge is directed from the first vertex to the the edge is directed from the first vertex to the

View File

@ -9,7 +9,8 @@
.Op Fl amnrsv .Op Fl amnrsv
.Sh DESCRIPTION .Sh DESCRIPTION
.Nm .Nm
writes system information to stdout. If no flags are given, writes system information to stdout.
If no flags are given,
.Nm .Nm
implies implies
.Fl s . .Fl s .

6
uniq.1
View File

@ -18,11 +18,13 @@ reads the
file and writes one copy of a line from each group of consecutive file and writes one copy of a line from each group of consecutive
duplicate lines to the duplicate lines to the
.Ar output .Ar output
file. If no file.
If no
.Ar input .Ar input
file is given file is given
.Nm .Nm
reads from stdin. If no reads from stdin.
If no
.Ar output .Ar output
file is given file is given
.Nm .Nm

View File

@ -14,9 +14,10 @@
reads reads
.Ar file .Ar file
and writes a decoded version to the file specified in the uuencoded header. and writes a decoded version to the file specified in the uuencoded header.
In case the file already exists, it is truncated. Otherwise a new file is In case the file already exists, it is truncated.
created. The permissions of the created/accessed file are changed to Otherwise a new file is created.
reflect the mode in the header. The permissions of the created/accessed file are changed to reflect the
mode in the header.
If no If no
.Ar file .Ar file
is given is given

19
xargs.1
View File

@ -21,15 +21,16 @@ with the strings as
.Pp .Pp
Any arguments specified on the command line are given to the command upon Any arguments specified on the command line are given to the command upon
each invocation, followed by some number of the arguments read from each invocation, followed by some number of the arguments read from
stdin. The command is repeatedly executed one or more times until stdin stdin.
is exhausted. The command is repeatedly executed one or more times until stdin is exhausted.
.Pp .Pp
Spaces, tabs and newlines may be embedded in arguments using single (`'') Spaces, tabs and newlines may be embedded in arguments using single (`'')
or double (`"') quotes or backslashes ('\\'). Single quotes escape all or double (`"') quotes or backslashes ('\\').
non-single quote characters, excluding newlines, up to the matching single Single quotes escape all non-single quote characters, excluding newlines, up
quote. Double quotes escape all non-double quote characters, excluding to the matching single quote.
newlines, up to the matching double quote. Any single character, including Double quotes escape all non-double quote characters, excluding newlines, up
newlines, may be escaped by a backslash. to the matching double quote.
Any single character, including newlines, may be escaped by a backslash.
.Sh OPTIONS .Sh OPTIONS
.Bl -tag -width Ds .Bl -tag -width Ds
.It Fl n Ar num .It Fl n Ar num
@ -37,8 +38,8 @@ Use at most
.Ar num .Ar num
arguments per command line. arguments per command line.
.It Fl r .It Fl r
Do not run the command if there are no arguments. Normally the command is Do not run the command if there are no arguments.
executed at least once even if there are no arguments. Normally the command is executed at least once even if there are no arguments.
.It Fl E Ar eofstr .It Fl E Ar eofstr
Use Use
.Ar eofstr .Ar eofstr

View File

@ -1,4 +1,4 @@
.Dd 2016-24-27 .Dd 2016-12-03
.Dt INSTALL 1 .Dt INSTALL 1
.Os sbase .Os sbase
.Sh NAME .Sh NAME
@ -31,7 +31,8 @@ If more than one
.Ar source .Ar source
is given is given
.Ar dest .Ar dest
is treated as a directory. Otherwise is treated as a directory.
Otherwise
.Ar dest .Ar dest
is treated as a filename. is treated as a filename.
.Nm .Nm
@ -52,12 +53,13 @@ Change the installed files' group to
.Ar group . .Ar group .
This may be a group name or a group identifier. This may be a group name or a group identifier.
.It Fl m Ar mode .It Fl m Ar mode
Change the file modes. Both numerical and symbolic Change the file modes.
values are supported. See Both numerical and symbolic values are supported.
See
.Xr chmod 1 .Xr chmod 1
for the syntex. for the syntex.
Default mode 0755. If a file has the mode 0644 and Default mode 0755.
is copied with If a file has the mode 0644 and is copied with
.It Fl o Ar owner .It Fl o Ar owner
Change the installed files' owner to Change the installed files' owner to
.Ar owner . .Ar owner .
@ -68,8 +70,8 @@ Copy files into the directory
.Nm install , .Nm install ,
the copy's mode will be 0755 unless the copy's mode will be 0755 unless
.Fl m .Fl m
is used to select another mode. When the symbolic is used to select another mode.
notation is used, the base mode is 0000. When the symbolic notation is used, the base mode is 0000.
.El .El
.Sh SEE ALSO .Sh SEE ALSO
.Xr chmod 1 , .Xr chmod 1 ,
@ -79,6 +81,6 @@ notation is used, the base mode is 0000.
.Sh STANDARDS .Sh STANDARDS
The The
.Nm .Nm
utility is not standardized. This implementation is a subset utility is not standardized.
of the GNU implementation and a subset with extensions to This implementation is a subset of the GNU implementation and a subset
the FreeBSD implementation. with extensions to the FreeBSD implementation.