From: Karl Berry <karl@freefriends.org>
Date: Sun, 6 Oct 2013 15:39:58 +0000 (+0100)
Subject: doc: expand the texinfo examples for the paste command
X-Git-Tag: v8.22~69
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=b72d08ef63093e040a24bcea479c036ba513f9d5;p=thirdparty%2Fcoreutils.git

doc: expand the texinfo examples for the paste command

* doc/coreutils.texi (paste invocation): Move the synopsis to the top.
Provide examples for the different type of operations possible.
Add a specific common example to join consecutive lines with a space.
---

diff --git a/doc/coreutils.texi b/doc/coreutils.texi
index 5b2f6247b8..b273627787 100644
--- a/doc/coreutils.texi
+++ b/doc/coreutils.texi
@@ -6067,8 +6067,13 @@ corresponding lines of each given file, separated by a TAB character.
 Standard input is used for a file name of @samp{-} or if no input files
 are given.
 
-For example:
+Synopsis:
 
+@example
+paste [@var{option}]@dots{} [@var{file}]@dots{}
+@end example
+
+For example, with:
 @example
 $ cat num2
 1
@@ -6077,16 +6082,37 @@ $ cat let3
 a
 b
 c
+@end example
+
+Take lines sequentially from each file:
+@example
 $ paste num2 let3
 1       a
 2       b
        @ c
 @end example
 
-Synopsis:
+Duplicate lines from a file:
+@example
+$ paste num2 let3 num2
+1       a      1
+2       b      2
+       @ c
+@end example
 
+Intermix lines from stdin:
 @example
-paste [@var{option}]@dots{} [@var{file}]@dots{}
+$ paste - let3 - < num2
+1       a      2
+       @ b
+       @ c
+@end example
+
+Join consecutive lines with a space:
+@example
+$ seq 4 | paste -d ' ' - -
+1 2
+3 4
 @end example
 
 The program accepts the following options.  Also see @ref{Common options}.