BSD 4_3_Reno release
[unix-history] / usr / src / usr.bin / split / split.1
index e047132..3aa9d5c 100644 (file)
@@ -1,38 +1,27 @@
-.\"    @(#)split.1     4.1 (Berkeley) %G%
+.\" Copyright (c) 1990 Regents of the University of California.
+.\" All rights reserved.  The Berkeley software License Agreement
+.\" specifies the terms and conditions for redistribution.
 .\"
 .\"
-.TH SPLIT 1 
+.\"     @(#)split.1    6.3 (Berkeley) 6/24/90
+.\"
+.TH SPLIT 1 "%Q"
 .AT 3
 .SH NAME
 split \- split a file into pieces
 .SH SYNOPSIS
 .AT 3
 .SH NAME
 split \- split a file into pieces
 .SH SYNOPSIS
-.B split
-[
-.B \-\fIn
-]
-[ file [ name ] ]
+\fBsplit\fP [ -\fBn\fP ] [ -\fBb\fP byte_cnt ] [ file [ name ] ]
 .SH DESCRIPTION
 .SH DESCRIPTION
-.I Split
-reads
-.I file
-and writes
-it in
+\fISplit\fP reads \fIfile\fP and writes it in
 .IR n -line
 .IR n -line
-pieces
-(default 1000), as many as necessary,
-onto
-a set of output files.  The name of the first output
-file is
-.I name
-with
-.B aa
-appended, and so on
-lexicographically.
-If no output name is given,
-.B x
-is default.
+pieces or in \fIbyte_cnt\fP byte pieces to a set of output
+files.  The default is in 1000 line pieces.  The name of the
+first output file is \fIname\fP with "aa" appended, and so
+on, lexicographically, to "zz".  If no output name is given,
+"x" is the default, in which case \fIsplit\fP will create
+files from "xaa" to "zzz".
 .PP
 .PP
-If no input file is given, or
-if
-.B \-
-is given in its stead,
-then the standard input file is used.
+If no input file is given, or if \fB-\fP is given in its stead, then
+the standard input file is used.
+.SH BUGS
+If you provide \fIname\fP, \fIsplit\fP can only create 676 separate
+files.  The default naming convention allows 2028 separate files.