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

98 lines
2.1 KiB
Groff
Raw Normal View History

Use ISO-date-format in manpages The one specified by mdoc is hard to read for non-native speakers from countries which read the date day-first (like Germany, Greece, North-Korea, Swamp,...). This is also consistent with how we generally specify dates at suckless.org.
2015-10-08 15:15:08 +00:00
.Dd 2015-10-08
remove sbase-VERSION from man page, fix sponge.1 date
2015-01-31 13:20:02 +00:00
.Dt XARGS 1
Add .Os sbase and sed replace to .Os sbase $(VERSION) in make install
2015-01-31 19:37:03 +00:00
.Os sbase
mandoc: convert uname.1, uniq.1 and xargs.1
2015-01-30 20:51:23 +00:00
.Sh NAME
.Nm xargs
Add s-, t-, x-flags to and audit xargs(1) The flexible design already allowed to add these flags trivially. Drop the -I and -L-flags, which are XSI-extensions. The audit generally consisted of style-changes, dropping kitchen- sink functions, updating the usage and using estrtonum instead of strtol.
2015-03-22 21:53:12 +00:00
.Nd construct argument lists and execute command
mandoc: convert uname.1, uniq.1 and xargs.1
2015-01-30 20:51:23 +00:00
.Sh SYNOPSIS
.Nm
Add s-, t-, x-flags to and audit xargs(1) The flexible design already allowed to add these flags trivially. Drop the -I and -L-flags, which are XSI-extensions. The audit generally consisted of style-changes, dropping kitchen- sink functions, updating the usage and using estrtonum instead of strtol.
2015-03-22 21:53:12 +00:00
.Op Fl rtx
mandoc: convert uname.1, uniq.1 and xargs.1
2015-01-30 20:51:23 +00:00
.Op Fl E Ar eofstr
Add s-, t-, x-flags to and audit xargs(1) The flexible design already allowed to add these flags trivially. Drop the -I and -L-flags, which are XSI-extensions. The audit generally consisted of style-changes, dropping kitchen- sink functions, updating the usage and using estrtonum instead of strtol.
2015-03-22 21:53:12 +00:00
.Op Fl n Ar num
.Op Fl s Ar num
.Op Ar cmd Op Ar arg ...
mandoc: convert uname.1, uniq.1 and xargs.1
2015-01-30 20:51:23 +00:00
.Sh DESCRIPTION
man pages: improve consistency
2015-02-01 19:52:28 +00:00
.Nm
reads space, tab, newline and EOF delimited strings from stdin
and executes the specified
.Ar cmd
with the strings as
.Ar arguments .
mandoc: convert uname.1, uniq.1 and xargs.1
2015-01-30 20:51:23 +00:00
.Pp
Add initial version of xargs(1)
2014-01-03 11:52:47 +00:00
Any arguments specified on the command line are given to the command upon
each invocation, followed by some number of the arguments read from
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.
2020-03-01 22:37:31 +00:00
stdin.
The command is repeatedly executed one or more times until stdin is exhausted.
mandoc: convert uname.1, uniq.1 and xargs.1
2015-01-30 20:51:23 +00:00
.Pp
Add initial version of xargs(1)
2014-01-03 11:52:47 +00:00
Spaces, tabs and newlines may be embedded in arguments using single (`'')
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.
2020-03-01 22:37:31 +00:00
or double (`"') quotes or backslashes ('\\').
Single quotes escape all non-single quote characters, excluding newlines, up
to the matching single quote.
Double quotes escape all non-double quote characters, excluding newlines, up
to the matching double quote.
Any single character, including newlines, may be escaped by a backslash.
mandoc: convert uname.1, uniq.1 and xargs.1
2015-01-30 20:51:23 +00:00
.Sh OPTIONS
.Bl -tag -width Ds
Add s-, t-, x-flags to and audit xargs(1) The flexible design already allowed to add these flags trivially. Drop the -I and -L-flags, which are XSI-extensions. The audit generally consisted of style-changes, dropping kitchen- sink functions, updating the usage and using estrtonum instead of strtol.
2015-03-22 21:53:12 +00:00
.It Fl n Ar num
man pages: improve consistency
2015-02-01 19:52:28 +00:00
Use at most
Add s-, t-, x-flags to and audit xargs(1) The flexible design already allowed to add these flags trivially. Drop the -I and -L-flags, which are XSI-extensions. The audit generally consisted of style-changes, dropping kitchen- sink functions, updating the usage and using estrtonum instead of strtol.
2015-03-22 21:53:12 +00:00
.Ar num
man pages: improve consistency
2015-02-01 19:52:28 +00:00
arguments per command line.
mandoc: convert uname.1, uniq.1 and xargs.1
2015-01-30 20:51:23 +00:00
.It Fl r
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.
2020-03-01 22:37:31 +00:00
Do not run the command if there are no arguments.
Normally the command is executed at least once even if there are no arguments.
mandoc: convert uname.1, uniq.1 and xargs.1
2015-01-30 20:51:23 +00:00
.It Fl E Ar eofstr
man pages: improve consistency
2015-02-01 19:52:28 +00:00
Use
.Ar eofstr
as a logical EOF marker.
Add s-, t-, x-flags to and audit xargs(1) The flexible design already allowed to add these flags trivially. Drop the -I and -L-flags, which are XSI-extensions. The audit generally consisted of style-changes, dropping kitchen- sink functions, updating the usage and using estrtonum instead of strtol.
2015-03-22 21:53:12 +00:00
.It Fl s Ar num
Use at most
.Ar num
bytes per command line.
.It Fl t
Write the command line to stderr before executing it.
.It Fl x
Terminate if the command line exceeds the system limit or the number of bytes
given with the
.Op Fl s
flag.
mandoc: convert uname.1, uniq.1 and xargs.1
2015-01-30 20:51:23 +00:00
.El
.Sh EXIT STATUS
Add s-, t-, x-flags to and audit xargs(1) The flexible design already allowed to add these flags trivially. Drop the -I and -L-flags, which are XSI-extensions. The audit generally consisted of style-changes, dropping kitchen- sink functions, updating the usage and using estrtonum instead of strtol.
2015-03-22 21:53:12 +00:00
.Nm
exits with one of the following values:
mandoc: convert uname.1, uniq.1 and xargs.1
2015-01-30 20:51:23 +00:00
.Bl -tag -width Ds
.It 0
Add s-, t-, x-flags to and audit xargs(1) The flexible design already allowed to add these flags trivially. Drop the -I and -L-flags, which are XSI-extensions. The audit generally consisted of style-changes, dropping kitchen- sink functions, updating the usage and using estrtonum instead of strtol.
2015-03-22 21:53:12 +00:00
All invocations of
.Ar cmd
returned a zero exit status.
mandoc: convert uname.1, uniq.1 and xargs.1
2015-01-30 20:51:23 +00:00
.It 123
Add s-, t-, x-flags to and audit xargs(1) The flexible design already allowed to add these flags trivially. Drop the -I and -L-flags, which are XSI-extensions. The audit generally consisted of style-changes, dropping kitchen- sink functions, updating the usage and using estrtonum instead of strtol.
2015-03-22 21:53:12 +00:00
One or more invocations of
.Ar cmd
returned a nonzero exit status.
mandoc: convert uname.1, uniq.1 and xargs.1
2015-01-30 20:51:23 +00:00
.It 124
Add s-, t-, x-flags to and audit xargs(1) The flexible design already allowed to add these flags trivially. Drop the -I and -L-flags, which are XSI-extensions. The audit generally consisted of style-changes, dropping kitchen- sink functions, updating the usage and using estrtonum instead of strtol.
2015-03-22 21:53:12 +00:00
.Ar cmd
exited with a 255 exit status.
mandoc: convert uname.1, uniq.1 and xargs.1
2015-01-30 20:51:23 +00:00
.It 125
Add s-, t-, x-flags to and audit xargs(1) The flexible design already allowed to add these flags trivially. Drop the -I and -L-flags, which are XSI-extensions. The audit generally consisted of style-changes, dropping kitchen- sink functions, updating the usage and using estrtonum instead of strtol.
2015-03-22 21:53:12 +00:00
.Ar cmd
was killed or stopped by a signal.
mandoc: convert uname.1, uniq.1 and xargs.1
2015-01-30 20:51:23 +00:00
.It 126
Add s-, t-, x-flags to and audit xargs(1) The flexible design already allowed to add these flags trivially. Drop the -I and -L-flags, which are XSI-extensions. The audit generally consisted of style-changes, dropping kitchen- sink functions, updating the usage and using estrtonum instead of strtol.
2015-03-22 21:53:12 +00:00
.Ar cmd
was found but could not be executed.
mandoc: convert uname.1, uniq.1 and xargs.1
2015-01-30 20:51:23 +00:00
.It 127
Add s-, t-, x-flags to and audit xargs(1) The flexible design already allowed to add these flags trivially. Drop the -I and -L-flags, which are XSI-extensions. The audit generally consisted of style-changes, dropping kitchen- sink functions, updating the usage and using estrtonum instead of strtol.
2015-03-22 21:53:12 +00:00
.Ar cmd
could not be found.
mandoc: convert uname.1, uniq.1 and xargs.1
2015-01-30 20:51:23 +00:00
.It 1
Some other error occurred.
.El
Add s-, t-, x-flags to and audit xargs(1) The flexible design already allowed to add these flags trivially. Drop the -I and -L-flags, which are XSI-extensions. The audit generally consisted of style-changes, dropping kitchen- sink functions, updating the usage and using estrtonum instead of strtol.
2015-03-22 21:53:12 +00:00
.Sh STANDARDS
The
.Nm
utility is compliant with the
POSIX 2013 audit Mostly manpage-shuffling according to the changes in the corrigendum, wording changes and more idiomatic expressions. All this is finished up by marking the POSIX 2013 conformant tools with .St -p1003.1-2013 which is not available in older mandoc builds or nroff, but which reflects what we actually did, so who cares? This is a huge step and it's not far until we can release sbase 0.1.
2015-03-27 16:22:48 +00:00
.St -p1003.1-2013
specification except from the
Add s-, t-, x-flags to and audit xargs(1) The flexible design already allowed to add these flags trivially. Drop the -I and -L-flags, which are XSI-extensions. The audit generally consisted of style-changes, dropping kitchen- sink functions, updating the usage and using estrtonum instead of strtol.
2015-03-22 21:53:12 +00:00
.Op Fl p
flag.
.Pp
The
.Op Fl r
flag is an extension to that specification.
Reference in New Issue Copy Permalink