man/csplit.1

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