I suggest the following small change to the paste node in the documentation. Sorry I don't have the git-fu to give you the patch in that format.
2013-10-04 Karl Berry <[email protected]> * coreutils.texi (paste invocation): Move synopsis to above existing example; add second example for standard input. --- ORIG/coreutils.texi 2013-02-11 01:37:28.000000000 -0800 +++ coreutils.texi 2013-10-04 16:31:13.602509258 -0700 @@ -5963,3 +5963,9 @@ -For example: +Synopsis: + +@example +paste [@var{option}]@dots{} [@var{file}]@dots{} +@end example + +Example: @@ -5979,8 +5985,2 @@ -Synopsis: - -@example -paste [@var{option}]@dots{} [@var{file}]@dots{} -@end example - The program accepts the following options. Also see @ref{Common options}. @@ -6019,2 +6019,10 @@ +Here is another example, to paste together consecutive lines from +standard input, with a delimiter of a space: + +@example +$ cat num2 | paste -d"" - - +1 2 +@end example + @exitstatus Diff finished at Fri Oct 4 16:31:15
