From: Jim Meyering <jim@meyering.net>
Date: Fri, 15 Feb 2002 15:22:32 +0000 (+0000)
Subject: Change 'split' to conform to POSIX.  It now accepts an -a or
X-Git-Tag: TEXTUTILS-2_0_21~77
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=80cb677ce9dd67d02979e576ba5a59dcb98ed3fa;p=thirdparty%2Fcoreutils.git

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.
---

diff --git a/doc/coreutils.texi b/doc/coreutils.texi
index da8a0528ce..6bc62a3bd9 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