diff options
author | keramida <keramida@FreeBSD.org> | 2006-08-08 21:25:22 +0000 |
---|---|---|
committer | keramida <keramida@FreeBSD.org> | 2006-08-08 21:25:22 +0000 |
commit | 7d23f1583e6ad8f51cc1aecedac76d865aeeed03 (patch) | |
tree | 616ff8a9a61a4572d2b05477d174bf3fe81d1bce /usr.bin/split/split.1 | |
parent | 2d628bb4d98b991fc187a29462ce204e463b7166 (diff) | |
download | FreeBSD-src-7d23f1583e6ad8f51cc1aecedac76d865aeeed03.zip FreeBSD-src-7d23f1583e6ad8f51cc1aecedac76d865aeeed03.tar.gz |
Update usage & SYNOPSIS and clarify that input files are not removed.
Sort getopt option handling of -p too, while here.
The changes are adapted from a patch by Ruslan Ermilov, posted as
followup to docs/33852.
PR: docs/33852
Submitted by: Gary W. Swearingen <swear@blarg.net>
MFC after: 1 week
Diffstat (limited to 'usr.bin/split/split.1')
-rw-r--r-- | usr.bin/split/split.1 | 32 |
1 files changed, 22 insertions, 10 deletions
diff --git a/usr.bin/split/split.1 b/usr.bin/split/split.1 index 5b17432..afd7dc4 100644 --- a/usr.bin/split/split.1 +++ b/usr.bin/split/split.1 @@ -32,7 +32,7 @@ .\" @(#)split.1 8.3 (Berkeley) 4/16/94 .\" $FreeBSD$ .\" -.Dd August 21, 2005 +.Dd August 9, 2006 .Dt SPLIT 1 .Os .Sh NAME @@ -40,17 +40,29 @@ .Nd split a file into pieces .Sh SYNOPSIS .Nm -.Op Fl a Ar suffix_length -.Op Fl b Ar byte_count Ns Op Cm k Ns | Ns Cm m .Op Fl l Ar line_count -.Op Fl p Ar pattern -.Op Ar file Op Ar name +.Op Fl a Ar suffix_length +.Op Ar file Op Ar prefix +.Nm +.Fl b Ar byte_count Ns +.Oo +.Cm k Ns | Ns Cm m +.Oc +.Op Fl a Ar suffix_length +.Op Ar file Op Ar prefix +.Nm +.Fl p Ar pattern +.Op Fl a Ar suffix_length +.Op Ar file Op Ar prefix .Sh DESCRIPTION The .Nm utility reads the given .Ar file -and breaks it up into files of 1000 lines each. +and breaks it up into files of 1000 lines each +(if no options are specified), leaving the +.Ar file +unchanged. If .Ar file is a single dash @@ -60,7 +72,7 @@ or absent, reads from the standard input. .Pp The options are as follows: -.Bl -tag -width Ds +.Bl -tag -width indent .It Fl a Ar suffix_length Use .Ar suffix_length @@ -81,7 +93,7 @@ is appended to the number, the file is split into megabyte pieces. .It Fl l Ar line_count Create smaller files -.Ar n +.Ar line_count lines in length. .It Fl p Ar pattern The file is split whenever an input line matches @@ -103,13 +115,13 @@ In this case, each file into which the file is split is named by the prefix followed by a lexically ordered suffix using .Ar suffix_length characters in the range -.Dq Li a-z . +.Dq Li a Ns - Ns Li z . If .Fl a is not specified, two letters are used as the suffix. .Pp If the -.Ar name +.Ar prefix argument is not specified, the file is split into lexically ordered files named with the prefix .Dq Li x |