diff options
| author | Jim Meyering <meyering@redhat.com> | 2010-12-17 21:58:33 +0100 |
|---|---|---|
| committer | Jim Meyering <meyering@redhat.com> | 2010-12-18 08:04:46 +0100 |
| commit | eea8e7530bf3c469dd7f4e598c993ff7fb4574e9 (patch) | |
| tree | 863a462fe0aa12587b6ee928a8f151978c66c1e1 | |
| parent | 6d488ca041eedbc833c2f73247c4deea380a0382 (diff) | |
| download | coreutils-eea8e7530bf3c469dd7f4e598c993ff7fb4574e9.tar.xz | |
doc: split: add examples showing how to use the new option
* doc/coreutils.texi (split invocation): Add examples.
| -rw-r--r-- | doc/coreutils.texi | 61 |
1 files changed, 61 insertions, 0 deletions
diff --git a/doc/coreutils.texi b/doc/coreutils.texi index 76fdce165..00a557578 100644 --- a/doc/coreutils.texi +++ b/doc/coreutils.texi @@ -3049,6 +3049,67 @@ Write a diagnostic just before each output file is opened. @exitstatus +Here are a few examples to illustrate how the +@option{--number} (@option{-n}) option works: + +Notice how, by default, one line may be split onto two or more: + +@example +$ seq -w 6 10 > k; split -n3 k; head xa? +==> xaa <== +06 +07 +==> xab <== + +08 +0 +==> xac <== +9 +10 +@end example + +Use the "l/" modifier to suppress that: + +@example +$ seq -w 6 10 > k; split -nl/3 k; head xa? +==> xaa <== +06 +07 + +==> xab <== +08 +09 + +==> xac <== +10 +@end example + +Use the "r/" modifier to distribute lines in a round-robin fashion: + +@example +$ seq -w 6 10 > k; split -nr/3 k; head xa? +==> xaa <== +06 +09 + +==> xab <== +07 +10 + +==> xac <== +08 +@end example + +You can also extract just the Kth chunk. +This extracts and prints just the 7th "chunk" of 33: + +@example +$ seq 100 > k; split -nl/7/33 k +20 +21 +22 +@end example + @node csplit invocation @section @command{csplit}: Split a file into context-determined pieces |