From: Jim Meyering <jim@meyering.net>
Date: Thu, 8 Nov 2001 09:28:13 +0000 (+0000)
Subject: (paste invocation): Give examples.
X-Git-Tag: TEXTUTILS-2_0_17~153
X-Git-Url: http://git.ipfire.org/gitweb/index.cgi?a=commitdiff_plain;h=8bfb607ef8b8cd61c4b47c52cc1f128ba74f36dc;p=thirdparty%2Fcoreutils.git

(paste invocation): Give examples.
Thanks to Dan Jacobson for suggesting the examples.
---

diff --git a/doc/coreutils.texi b/doc/coreutils.texi
index 589774170e..e7273ec578 100644
--- a/doc/coreutils.texi
+++ b/doc/coreutils.texi
@@ -3901,6 +3901,22 @@ 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:
+
+@example
+$ cat num2
+1
+2
+$ cat let3
+a
+b
+c
+$ paste num2 let3
+1       a
+2       b
+        c
+@end example
+
 Synopsis:
 
 @example
@@ -3916,7 +3932,13 @@ The program accepts the following options.  Also see @ref{Common options}.
 @opindex -s
 @opindex --serial
 Paste the lines of one file at a time rather than one line from each
-file.
+file.  Using the above example data:
+
+@example
+$ paste -s num2 let3
+1       2
+a       b       c
+@end example
 
 @item -d @var{delim-list}
 @itemx --delimiters=@var{delim-list}
@@ -3924,7 +3946,14 @@ file.
 @opindex --delimiters
 Consecutively use the characters in @var{delim-list} instead of
 TAB to separate merged lines.  When @var{delim-list} is
-exhausted, start again at its beginning.
+exhausted, start again at its beginning.  Using the above example data:
+
+@example
+$ paste -d '%_' num2 let3 num2
+1%a_1
+2%b_2
+%c_
+@end example
 
 @end table