20050223 working copy
[uzi.git] / bin / man / man1 / split.1
1 .TH SPLIT 1 
2 .SH NAME
3 split \- split a file into pieces
4 .SH SYNOPSIS
5 .B split
6 [
7 .B \-\fIn
8 ]
9 [ file [ name ] ]
10 .SH DESCRIPTION
11 .I Split
12 reads
13 .I file
14 and writes
15 it in
16 .IR n -line
17 pieces
18 (default 1000), as many as necessary,
19 onto
20 a set of output files.  The name of the first output
21 file is
22 .I name
23 with
24 .B aa
25 appended, and so on
26 lexicographically.
27 If no output name is given,
28 .B x
29 is default.
30 .PP
31 If no input file is given, or
32 if
33 .B \-
34 is given in its stead,
35 then the standard input file is used.