manual/GNU_textutils/original/man1/csplit.1

   1 .\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.012.
   2 .TH CSPLIT "1" "August 1999" "GNU textutils 2.0" FSF
   3 .SH NAME
   4 csplit \- split a file into sections determined by context lines
   5 .SH SYNOPSIS
   6 .B csplit
   7 [\fIOPTION\fR]...\fI FILE PATTERN\fR...
   8 .SH DESCRIPTION
   9 .PP
  10 .\" Add any additional description here
  11 .PP
  12 Output pieces of FILE separated by PATTERN(s) to files `xx01', `xx02', ...,
  13 and output byte counts of each piece to standard output.
  14 .IP
  15 \fB\-b\fR, \fB\-\-suffix\-format\fR=\fIFORMAT\fR use sprintf FORMAT instead of %d
  16 \fB\-f\fR, \fB\-\-prefix\fR=\fIPREFIX\fR        use PREFIX instead of `xx'
  17 \fB\-k\fR, \fB\-\-keep\-files\fR           do not remove output files on errors
  18 \fB\-n\fR, \fB\-\-digits\fR=\fIDIGITS\fR        use specified number of digits instead of 2
  19 \fB\-s\fR, \fB\-\-quiet\fR, \fB\-\-silent\fR      do not print counts of output file sizes
  20 \fB\-z\fR, \fB\-\-elide\-empty\-files\fR    remove empty output files
  21 .TP
  22 \fB\-\-help\fR
  23 display this help and exit
  24 .TP
  25 \fB\-\-version\fR
  26 output version information and exit
  27 .PP
  28 Read standard input if FILE is -.  Each PATTERN may be:
  29 .TP
  30 INTEGER
  31 copy up to but not including specified line number
  32 .TP
  33 /REGEXP/[OFFSET]
  34 copy up to but not including a matching line
  35 .TP
  36 %REGEXP%[OFFSET]
  37 skip to, but not including a matching line
  38 .TP
  39 {INTEGER}
  40 repeat the previous pattern specified number of times
  41 .TP
  42 {*}
  43 repeat the previous pattern as many times as possible
  44 .PP
  45 A line OFFSET is a required `+' or `-' followed by a positive integer.
  46 .SH "REPORTING BUGS"
  47 Report bugs to <bug-textutils@gnu.org>.
  48 .SH "SEE ALSO"
  49 The full documentation for
  50 .B csplit
  51 is maintained as a Texinfo manual.  If the
  52 .B info
  53 and
  54 .B csplit
  55 programs are properly installed at your site, the command
  56 .IP
  57 .B info csplit
  58 .PP
  59 should give you access to the complete manual.
  60 .SH COPYRIGHT
  61 Copyright \(co 1999 Free Software Foundation, Inc.
  62 .br
  63 This is free software; see the source for copying conditions.  There is NO
  64 warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.