Add mandoc-manpage for paste(1)

and mark it as finished in README.

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

paste.1

@@ -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
-.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)