sbase

suckless unix tools
git clone git://git.2f30.org/sbase.git
Log | Files | Refs | README | LICENSE

commit d4e2067d3decf44a915df56475a681b70a623b53
parent cdbc0d50356a0f7e0dd5755e3c46593a947cf029
Author: FRIGN <dev@frign.de>
Date:   Thu Jan 29 21:26:09 +0100

Add mandoc-manpage for paste(1)

and mark it as finished in README.

Diffstat:
README | 2+-
paste.1 | 170+++++++++++++++++++++++--------------------------------------------------------
2 files changed, 50 insertions(+), 122 deletions(-)
diff --git a/README b/README @@ -49,7 +49,7 @@ The following tools are implemented ('*' == finished, '#' == UTF-8 support, =* nice yes none = nl no -d, -f, -h, -l, -n, -p, -v, -w =* nohup yes none -# paste yes none +#* paste yes none = printenv non-posix none printf stolen stolen =* pwd yes none diff --git a/paste.1 b/paste.1 @@ -1,122 +1,50 @@ -.TH PASTE 1 paste-VERSION "Apr 2013" -.SH NAME -paste \- merge corresponding or subsequent lines of files -.SH "SYNOPSIS" -.PP -.B paste -[ -.B \-s -] -[ -.B \-d -.I list -] -.I file... -.SH DESCRIPTION +.Dd January 29, 2015 +.Dt PASTE 1 sbase\-VERSION +.Sh NAME +.Nm paste +.Nd merge lines of files in parallel or sequentially +.Sh SYNOPSIS +.Nm paste +.Op Fl s +.Op Fl d Ar list +.Ar file ... +.Sh DESCRIPTION +.Nm +reads single lines from each +.Ar file +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 -.B paste -utility concatenates the corresponding lines of the given input files, -and writes the resulting lines to standard output. The default operation -of -.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) +.Nm +utility is compliant with the +.St -p1003.1-2008 +specification.