summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorJim Meyering <jim@meyering.net>2002-02-15 15:22:32 +0000
committerJim Meyering <jim@meyering.net>2002-02-15 15:22:32 +0000
commit80cb677ce9dd67d02979e576ba5a59dcb98ed3fa (patch)
tree047f4acbaeb5fa5c863e6ca212bddb8139f1082e /doc
parent18a3d6a8aaf0e3ca1cf43126121bb67c6bab1cf4 (diff)
downloadcoreutils-80cb677ce9dd67d02979e576ba5a59dcb98ed3fa.tar.xz
Change 'split' to conform to POSIX. It now accepts an -a or
--suffix-length option, and refuses to generate more files than there are suffixes. Document this.
Diffstat (limited to 'doc')
-rw-r--r--doc/coreutils.texi15
1 files changed, 11 insertions, 4 deletions
diff --git a/doc/coreutils.texi b/doc/coreutils.texi
index da8a0528c..6bc62a3bd 100644
--- a/doc/coreutils.texi
+++ b/doc/coreutils.texi
@@ -2231,15 +2231,22 @@ left over for the last section), into each output file.
@cindex output file name prefix
The output files' names consist of @var{prefix} (@samp{x} by default)
-followed by a group of letters @samp{aa}, @samp{ab}, and so on, such
-that concatenating the output files in sorted order by file name produces
-the original input file. (If more than 676 output files are required,
-@code{split} uses @samp{zaa}, @samp{zab}, etc.)
+followed by a group of letters (@samp{aa}, @samp{ab}, @dots{} by default),
+such that concatenating the output files in sorted order by file name produces
+the original input file. If the output file names are exhausted,
+@command{split} reports an error without deleting the output files
+that it did create.
The program accepts the following options. Also see @ref{Common options}.
@table @samp
+@item -a @var{length}
+@itemx --suffix-length=@var{length}
+@opindex -a
+@opindex --suffix-length
+Use suffixes of length @var{length}. The default @var{length} is 2.
+
@item -l @var{lines}
@itemx --lines=@var{lines}
@opindex -l