summaryrefslogtreecommitdiff
path: root/man/csplit.1
blob: ffd4b5400df6003e1b7e3ec97ee0cc94ce266d48 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.35.
.TH CSPLIT "1" "March 2007" "GNU coreutils 6.9" "User Commands"
.SH NAME
csplit \- split a file into sections determined by context lines
.SH SYNOPSIS
.B csplit
[\fIOPTION\fR]... \fIFILE PATTERN\fR...
.SH DESCRIPTION
.\" Add any additional description here
.PP
Output pieces of FILE separated by PATTERN(s) to files `xx00', `xx01', ...,
and output byte counts of each piece to standard output.
.PP
Mandatory arguments to long options are mandatory for short options too.
.TP
\fB\-b\fR, \fB\-\-suffix\-format\fR=\fIFORMAT\fR
use sprintf FORMAT instead of %02d
.TP
\fB\-f\fR, \fB\-\-prefix\fR=\fIPREFIX\fR
use PREFIX instead of `xx'
.TP
\fB\-k\fR, \fB\-\-keep\-files\fR
do not remove output files on errors
.TP
\fB\-n\fR, \fB\-\-digits\fR=\fIDIGITS\fR
use specified number of digits instead of 2
.TP
\fB\-s\fR, \fB\-\-quiet\fR, \fB\-\-silent\fR
do not print counts of output file sizes
.TP
\fB\-z\fR, \fB\-\-elide\-empty\-files\fR
remove empty output files
.TP
\fB\-\-help\fR
display this help and exit
.TP
\fB\-\-version\fR
output version information and exit
.PP
Read standard input if FILE is \-.  Each PATTERN may be:
.TP
INTEGER
copy up to but not including specified line number
.TP
/REGEXP/[OFFSET]
copy up to but not including a matching line
.TP
%REGEXP%[OFFSET]
skip to, but not including a matching line
.TP
{INTEGER}
repeat the previous pattern specified number of times
.TP
{*}
repeat the previous pattern as many times as possible
.PP
A line OFFSET is a required `+' or `\-' followed by a positive integer.
.SH AUTHOR
Written by Stuart Kemp and David MacKenzie.
.SH "REPORTING BUGS"
Report bugs to <bug\-coreutils@gnu.org>.
.SH COPYRIGHT
Copyright \(co 2007 Free Software Foundation, Inc.
.br
This is free software.  You may redistribute copies of it under the terms of
the GNU General Public License <http://www.gnu.org/licenses/gpl.html>.
There is NO WARRANTY, to the extent permitted by law.
.SH "SEE ALSO"
The full documentation for
.B csplit
is maintained as a Texinfo manual.  If the
.B info
and
.B csplit
programs are properly installed at your site, the command
.IP
.B info csplit
.PP
should give you access to the complete manual.