fbt/sbase
1
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity

mandoc: convert uname.1, uniq.1 and xargs.1

Browse Source
This commit is contained in:
Hiltjo Posthuma 2015-01-30 21:51:23 +01:00
parent a7e0f6b4f1
commit 9d12daf179
3 changed files with 102 additions and 97 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

50
uname.1
View File

@ -1,32 +1,32 @@
.TH UNAME 1 sbase\-VERSION .Dd January 30, 2015
.SH NAME .Dt UNAME 1 sbase\-VERSION
uname \- print system information .Os
.SH SYNOPSIS .Sh NAME
.B uname .Nm uname
.RB [ \-amnrsv ] .Nd print system information
.SH DESCRIPTION .Sh SYNOPSIS
.B uname .Nm
.Op Fl amnrsv
.Sh DESCRIPTION
.Nm
prints system information. If no flags are given, uname will print only the prints system information. If no flags are given, uname will print only the
name of the operating system name of the operating system as
.RB ( \-s ). .Fl s
.SH OPTIONS would.
.TP .Sh OPTIONS
.B \-a .Bl -tag -width Ds
.It Fl a
print all the information below. print all the information below.
.TP .It Fl m
.B \-m
print the machine's architecture. print the machine's architecture.
.TP .It Fl n
.B \-n
print the system's network name. print the system's network name.
.TP .It Fl r
.B \-r
print the operating system's release name. print the operating system's release name.
.TP .It Fl s
.B \-s
print the name of the operating system. print the name of the operating system.
.TP .It Fl v
.B \-v
print the operating system's version name. print the operating system's version name.
.SH SEE ALSO .El
.IR uname (2) .Sh SEE ALSO
.Xr uname 2

76
uniq.1
View File

@ -1,39 +1,39 @@
.TH UNIQ 1 sbase\-VERSION .Dd January 30, 2015
.SH NAME .Dt UNIQ 1 sbase\-VERSION
uniq \- multi-column .Os
.SH SYNOPSIS .Sh NAME
.B uniq .Nm uniq
.RB [ \-cdu ] .Nd report or filter out repeated lines in a file
.RI [ file ] .Sh SYNOPSIS
.SH DESCRIPTION .Nm
.B uniq .Op Fl cdu
reads file and writes one copy of a line .Op Ar file
from each group of consecutive duplicate lines .Sh DESCRIPTION
to stdout. .Nm
If no file is given, uniq reads from stdin. reads file and writes one copy of a line from each group of consecutive
.SH OPTIONS duplicate lines to stdout. If no file is given, uniq reads from stdin.
.TP .Sh OPTIONS
.B \-c .Bl -tag -width Ds
prefixes each line with a count .It Fl c
of its consecutive occurrences in the input. prefixes each line with a count of its consecutive occurrences in the input.
.TP .It Fl d
.B \-d suppresses non-duplicate lines (thus 'uniq -d' prints only duplicates).
suppresses non-duplicate lines .It Fl u
(thus 'uniq -d' prints only duplicates). suppresses non-unique lines (thus 'uniq -u' prints only uniques).
.TP .El
.B \-u .Sh BUGS
suppresses non-unique lines
(thus 'uniq -u' prints only uniques).
.SH BUGS
The original sbase implementation of The original sbase implementation of
.B uniq .Nm
supported multiple input-file arguments, supported multiple input-file arguments as e.g.
as e.g. cat and grep do. .Xr cat 1
Unfortunately, POSIX uniq treats its second argument (if present) and
as an output filename and clobbers it. .Xr grep 1
Since users and scripts which rely on uniq do.
supporting multiple input-file arguments Unfortunately, POSIX uniq treats its second argument (if present) as an
would be at risk of data loss output filename and clobbers it. Since users and scripts which rely on
if they ever ran into a POSIX-compatible uniq, .Nm
support for multiple input-file arguments supporting multiple input-file arguments would be at risk of data loss
was removed from this implementation. if they ever ran into a POSIX-compatible
.Nm
, support for multiple input-file arguments was removed from this
implementation.

71
xargs.1
View File

@ -1,50 +1,55 @@
.TH XARGS 1 sbase\-VERSION .Dd January 30, 2015
.SH NAME .Dt XARGS 1 sbase\-VERSION
xargs \- constuct argument list(s) and execute command .Os
.SH SYNOPSIS .Sh NAME
.B xargs .Nm xargs
.RB [\-n .Nd constuct argument list(s) and execute command
.IR maxargs ] .Sh SYNOPSIS
.RB [ \-r ] .Nm
.RB [ \-E .Op Fl n Ar maxargs
.IR eofstr ] .Op Fl r
.RI [ cmd .Op Fl E Ar eofstr
.IR [arg... ] ] .Op Ar cmd Op Ar arg...
.SH DESCRIPTION .Sh DESCRIPTION
xargs reads space, tab, newline and EOF delimited strings from stdin xargs reads space, tab, newline and EOF delimited strings from stdin
and executes the specified cmd with the strings as arguments. and executes the specified cmd with the strings as arguments.
.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. The command is repeatedly executed one or more times until stdin
is exhausted. is exhausted.
.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 ('\\'). Single quotes escape all
non-single quote characters, excluding newlines, up to the matching single non-single quote characters, excluding newlines, up to the matching single
quote. Double quotes escape all non-double quote characters, excluding quote. Double quotes escape all non-double quote characters, excluding
newlines, up to the matching double quote. Any single character, including newlines, up to the matching double quote. Any single character, including
newlines, may be escaped by a backslash. newlines, may be escaped by a backslash.
.SH OPTIONS .Sh OPTIONS
.TP .Bl -tag -width Ds
.B \-n maxargs .It Fl n Ar maxargs
Use at most maxargs arguments per command line. Use at most maxargs arguments per command line.
.TP .It Fl r
.BI \-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. Normally the command is
executed at least once even if there are no arguments. executed at least once even if there are no arguments.
.TP .It Fl E Ar eofstr
.B \-E eofstr
Use eofstr as a logical EOF marker. Use eofstr as a logical EOF marker.
.SH EXIT STATUS .El
.Sh EXIT STATUS
xargs exits with one of the following values: xargs exits with one of the following values:
.Bl -tag -width Ds
0 All invocations of command returned a zero exit .It 0
status. All invocations of command returned a zero exit status.
123 One or more invocations of command returned a .It 123
nonzero exit status. One or more invocations of command returned a nonzero exit status.
124 The command exited with a 255 exit status. .It 124
125 The command was killed or stopped by a signal. The command exited with a 255 exit status.
126 The command was found but could not be executed. .It 125
127 The command could not be found. The command was killed or stopped by a signal.
1 Some other error occurred. .It 126
The command was found but could not be executed.
.It 127
The command could not be found.
.It 1
Some other error occurred.
.El