1 .TH SPLIT 1
2 .CT 1 files
3 .SH NAME
4 split \- split a file into pieces
5 .SH SYNOPSIS
6 .B split
7 [
8 .I option ...
9 ]
10 [
11 .I file
12 ]
13 .SH DESCRIPTION
14 .I Split
15 reads
16 .I file
17 (standard input by default)
18 and writes it in pieces of 1000
19 lines per output file.
20 The names of the
21 output files are
22 .BR xaa ,
23 .BR xab ,
24 and so on to
25 .BR xzz .
26 The options are
27 .TP
28 .BI -n " n"
29 Split into
30 .IR n -line
31 pieces.
32 .TP
33 .BI -l " n"
34 Synonym for
35 .B -n
36 .IR n ,
37 a nod to Unix's syntax.
38 .TP
39 .BI -e " expression"
40 File divisions occur at each line
41 that matches a regular
42 .IR expression ;
43 see 
44 .MR regexp (7) .
45 Multiple
46 .B -e
47 options may appear.
48 If a subexpression of
49 .I expression
50 is contained in parentheses
51 .BR ( ... ) ,
52 the output file name is the portion of the
53 line which matches the subexpression.
54 .TP
55 .BI -f " stem
56 Use
57 .I stem
58 instead of
59 .B x
60 in output file names.
61 .TP
62 .BI -s " suffix
63 Append
64 .I suffix
65 to names identified under
66 .BR -e .
67 .TP
68 .B -x
69 Exclude the matched input line from the output file.
70 .TP
71 .B -i
72 Ignore case in option
73 .BR -e ;
74 force output file names (excluding the suffix)
75 to lower case.
76 .SH SOURCE
77 .B \*9/src/cmd/split.c
78 .SH SEE ALSO
79 .IR sed (1), 
80 .MR awk (1) ,
81 .MR grep (1) ,
82 .MR regexp (7)