[hackers] [sbase] Add mandoc-manpage for paste(1) || FRIGN

From: <git_AT_suckless.org>
Date: Thu, 29 Jan 2015 21:33:17 +0100 (CET)

commit 25457e2a60ebdfba8f9579b35f7b2c58161f3a35
Author: FRIGN <dev_AT_frign.de>
Date: Thu Jan 29 21:26:09 2015 +0100

    Add mandoc-manpage for paste(1)
    
    and mark it as finished in README.

diff --git a/README b/README
index 82b524b..a2ee3f3 100644
--- a/README
+++ b/README
_AT_@ -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
index fdfd973..7e426bc 100644
--- a/paste.1
+++ b/paste.1
_AT_@ -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.
Received on Thu Jan 29 2015 - 21:33:17 CET