original/man1/csplit.1

   1 .\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.47.3.
   2 .TH CSPLIT "1" "January 2016" "GNU coreutils 8.25" "User Commands"
   3 .SH NAME
   4 csplit \- split a file into sections determined by context lines
   5 .SH SYNOPSIS
   6 .B csplit
   7 [\fI\,OPTION\/\fR]... \fI\,FILE 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 Read standard input if FILE is \-
  15 .PP
  16 Mandatory arguments to long options are mandatory for short options too.
  17 .TP
  18 \fB\-b\fR, \fB\-\-suffix\-format\fR=\fI\,FORMAT\/\fR
  19 use sprintf FORMAT instead of %02d
  20 .TP
  21 \fB\-f\fR, \fB\-\-prefix\fR=\fI\,PREFIX\/\fR
  22 use PREFIX instead of 'xx'
  23 .TP
  24 \fB\-k\fR, \fB\-\-keep\-files\fR
  25 do not remove output files on errors
  26 .TP
  27 \fB\-\-suppress\-matched\fR
  28 suppress the lines matching PATTERN
  29 .TP
  30 \fB\-n\fR, \fB\-\-digits\fR=\fI\,DIGITS\/\fR
  31 use specified number of digits instead of 2
  32 .TP
  33 \fB\-s\fR, \fB\-\-quiet\fR, \fB\-\-silent\fR
  34 do not print counts of output file sizes
  35 .TP
  36 \fB\-z\fR, \fB\-\-elide\-empty\-files\fR
  37 remove empty output files
  38 .TP
  39 \fB\-\-help\fR
  40 display this help and exit
  41 .TP
  42 \fB\-\-version\fR
  43 output version information and exit
  44 .SS "Each PATTERN may be:"
  45 .TP
  46 INTEGER
  47 copy up to but not including specified line number
  48 .TP
  49 /REGEXP/[OFFSET]
  50 copy up to but not including a matching line
  51 .TP
  52 %REGEXP%[OFFSET]
  53 skip to, but not including a matching line
  54 .TP
  55 {INTEGER}
  56 repeat the previous pattern specified number of times
  57 .TP
  58 {*}
  59 repeat the previous pattern as many times as possible
  60 .PP
  61 A line OFFSET is a required '+' or '\-' followed by a positive integer.
  62 .SH AUTHOR
  63 Written by Stuart Kemp and David MacKenzie.
  64 .SH "REPORTING BUGS"
  65 GNU coreutils online help: <http://www.gnu.org/software/coreutils/>
  66 .br
  67 Report csplit translation bugs to <http://translationproject.org/team/>
  68 .SH COPYRIGHT
  69 Copyright \(co 2016 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 Full documentation at: <http://www.gnu.org/software/coreutils/csplit>
  76 .br
  77 or available locally via: info \(aq(coreutils) csplit invocation\(aq