Add mandoc-manpage for paste(1)

and mark it as finished in README.
This commit is contained in:
FRIGN 2015-01-29 21:26:09 +01:00
parent cdbc0d5035
commit d4e2067d3d
2 changed files with 50 additions and 122 deletions

2
README
View File

@ -49,7 +49,7 @@ The following tools are implemented ('*' == finished, '#' == UTF-8 support,
=* nice yes none =* nice yes none
= nl no -d, -f, -h, -l, -n, -p, -v, -w = nl no -d, -f, -h, -l, -n, -p, -v, -w
=* nohup yes none =* nohup yes none
# paste yes none #* paste yes none
= printenv non-posix none = printenv non-posix none
printf stolen stolen printf stolen stolen
=* pwd yes none =* pwd yes none

170
paste.1
View File

@ -1,122 +1,50 @@
.TH PASTE 1 paste-VERSION "Apr 2013" .Dd January 29, 2015
.SH NAME .Dt PASTE 1 sbase\-VERSION
paste \- merge corresponding or subsequent lines of files .Sh NAME
.SH "SYNOPSIS" .Nm paste
.PP .Nd merge lines of files in parallel or sequentially
.B paste .Sh SYNOPSIS
[ .Nm paste
.B \-s .Op Fl s
] .Op Fl d Ar list
[ .Ar file ...
.B \-d .Sh DESCRIPTION
.I list .Nm
] reads single lines from each
.I file... .Ar file
.SH DESCRIPTION and writes them into one line, replacing
.Sy \en
with
.Sy \et
except from the last
.Ar file .
This process is repeated until each
.Ar file
is starved, treating zero-reads as empty lines along the way.
.Pp
If
.Ar file
is '-',
.Nm
interprets it as stdin.
.Sh OPTIONS
.Bl -tag -width Ds
.It Fl d Ar list
Replace
.Sy \en
with escaped characters from
.Ar list
by cycling through it.
.It Fl s
Read each
.Ar file
sequentially instead of in parallel.
.El
.Sh SEE ALSO
.Xr cut 1
.Sh STANDARDS
The The
.B paste .Nm
utility concatenates the corresponding lines of the given input files, utility is compliant with the
and writes the resulting lines to standard output. The default operation .St -p1003.1-2008
of specification.
.B paste
concatenates the corresponding lines of the input files.
The newline of every line except the line from the last input file is
replaced with a tab.
If an end-of-file condition is detected on one or more input files,
but not all input files,
.B paste
behaves as though empty lines were read from the files on which
end-of-file was detected, unless the
.B \-s
option is specified.
.SH OPTIONS
.TP
.B \-d list
unless a backslash character appears in
.I list
each character is an element specifying a delimiter.
If a backslash character appears, that and one or more characters
following it are an element specifying a delimiter.
These elements specify one or more characters to use,
instead of the default tab, to replace the newline of the input
lines. The elements in
.I list
are used circularly; that is, when the
.I list
is exhausted the first element from the list is reused.
When the
.B \-s
option is specified, the last newline in a file is not be modified.
The delimiter is reset to the first element of list after each file
operand is processed.
If a backslash character appears in list, it and the character following
it represents the following delimiters:
.RS
.TP
.I \en
newline character
.TP
.I \et
tab character
.TP
.I \e\e
backslash character
.TP
.I \e0
empty string (not a null character)
.TP
If Any other characters follow the backslash, results are unspecified.
.RE
.TP
.B \-s
concatenate all of the lines of each separate input file in command line
order. The newline of every line except the last line in each input file
are replaced with the tab, unless otherwise specified by the
.B \-d
option.
.PP
If '\-' is specified for one or more input files, the standard input is
used; standard input is read one line at a time, circularly for each
instance of '\-'.
.SH EXIT VALUES
The
.B paste
utility exits 0 on successful completion, and >0 if an error
occurs.
.SH ENVIRONMENT VARIABLES
The following environment variables affect the execution:
.TP
.B LANG
provide a default value for the internationalization variables
that are unset or null.
.TP
.B LC_ALL
if set to a non-empty string value, override the values of all the
other internationalization variables.
.TP
.B LC_CTYPE
determine the locale for the interpretation of sequences of bytes
of text data as characters (for example, single-byte as opposed to
multi-byte characters in arguments and input files).
.TP
.B LC_MESSAGES
determine the locale that should be used to affect the format and
contents of diagnostic messages written to standard error.
.SH CONFORMING TO
The
.B paste
utility is IEEE Std 1003.2 (POSIX.2) compatible.
.SH EXAMPLES
.TP
.I "ls | paste - - - -"
.PP
Write out a directory in four columns.
.TP
.I "paste -s -d '\et\en' file"
.PP
Combine pairs of lines from a file into single lines.
.SH AUTHOR
Written by Lorenzo Cogotti.
.SH SEE ALSO
.BR cut(1)
.BR lam(1)