original/man1/csplit.1

   1 .\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.35.
   2 .TH CSPLIT "1" "March 2012" "GNU coreutils 8.16" "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 csplit bugs to bug\-coreutils@gnu.org
  62 .br
  63 GNU coreutils home page: <http://www.gnu.org/software/coreutils/>
  64 .br
  65 General help using GNU software: <http://www.gnu.org/gethelp/>
  66 .br
  67 Report csplit translation bugs to <http://translationproject.org/team/>
  68 .SH COPYRIGHT
  69 Copyright \(co 2012 Free Software Foundation, Inc.
  70 License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>.
  71 .br
  72 This is free software: you are free to change and redistribute it.
  73 There is NO WARRANTY, to the extent permitted by law.
  74 .SH "SEE ALSO"
  75 The full documentation for
  76 .B csplit
  77 is maintained as a Texinfo manual.  If the
  78 .B info
  79 and
  80 .B csplit
  81 programs are properly installed at your site, the command
  82 .IP
  83 .B info coreutils \(aqcsplit invocation\(aq
  84 .PP
  85 should give you access to the complete manual.