← Back to branch summary

~ubuntu-branches/ubuntu/natty/9base/natty

« back to all changes in this revision

Viewing changes to split/split.1

  • Committer: Bazaar Package Importer
  • Author(s): Daniel Baumann
  • Date: 2010-06-04 17:22:03 UTC
  • mfrom: (1.1.6 upstream)
  • Revision ID: james.westby@ubuntu.com-20100604172203-ei85j0da495sr8ut
Tags: 1:6-1
* Adding Kai as co-maintainer.
* Merging upstream version 6.

Show diffs side-by-side

added added

removed removed

Lines of Context:
split/split.1
 
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
.IR 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
.IR awk (1),
 
81
.IR grep (1),
 
82
.IR regexp (7)