1
0
mirror of git://git.sv.gnu.org/coreutils.git synced 2026-04-20 10:51:48 +02:00

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.
This commit is contained in:
Karl Berry
2013-10-06 16:39:58 +01:00
committed by Pádraig Brady
parent 5ee7d8f55b
commit b72d08ef63

View File

@@ -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 [@var{option}]@dots{} [@var{file}]@dots{}
$ paste num2 let3 num2
1 a 1
2 b 2
@ c
@end example
Intermix lines from stdin:
@example
$ 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}.