home *** CD-ROM | disk | FTP | other *** search
/ Frozen Fish 1: Amiga / FrozenFish-Apr94.iso / bbs / gnu / textutils-1.9-bin.lha / man / cat1 / csplit.0 < prev    next >
Text File  |  1993-12-07  |  4KB  |  133 lines
  1.  
  2.  
  3.  
  4. CSPLIT(1L)                                             CSPLIT(1L)
  5.  
  6.  
  7. NNAAMMEE
  8.        csplit  - split a file into sections determined by context
  9.        lines
  10.  
  11. SSYYNNOOPPSSIISS
  12.        ccsspplliitt [-sk] [-f  prefix]  [-n  digits]  [--prefix=prefix]
  13.        [--digits=digits]   [--quiet]   [--silent]  [--keep-files]
  14.        [--help] [--version] file pattern...
  15.  
  16. DDEESSCCRRIIPPTTIIOONN
  17.        This manual page documents  the  GNU  version  of  ccsspplliitt.
  18.        ccsspplliitt  creates  zero or more output files containing sec-
  19.        tions of the given input _f_i_l_e, or the  standard  input  if
  20.        the name `-' is given.  By default, ccsspplliitt prints the num-
  21.        ber of bytes written to each output file after it has been
  22.        created.
  23.  
  24.        The  contents  of  the  output files are determined by the
  25.        _p_a_t_t_e_r_n arguments.  An error occurs if a pattern  argument
  26.        refers to a nonexistent line of the input file, such as if
  27.        no remaining line  matches  a  given  regular  expression.
  28.        After  all  the  given  patterns  have  been  matched, any
  29.        remaining output is copied into one last output file.  The
  30.        types of pattern arguments are:
  31.  
  32.               _l_i_n_e
  33.                      Create an output file containing the current
  34.                      line up to (but not including) line _l_i_n_e  (a
  35.                      positive  integer)  of  the  input file.  If
  36.                      followed by a repeat count, also  create  an
  37.                      output  file  containing the next _l_i_n_e lines
  38.                      of the input file once for each repeat.
  39.  
  40.               /_r_e_g_e_x_p/[_o_f_f_s_e_t]
  41.                      Create an output file containing the current
  42.                      line up to (but not including) the next line
  43.                      of the input file that contains a match  for
  44.                      _r_e_g_e_x_p.  The optional _o_f_f_s_e_t is a `+' or `-'
  45.                      followed by a positive integer.   If  it  is
  46.                      given,  the  input  up  to the matching line
  47.                      plus or minus _o_f_f_s_e_t is put into the  output
  48.                      file,  and  the  line  after that begins the
  49.                      next section of input.
  50.  
  51.               %_r_e_g_e_x_p%[_o_f_f_s_e_t]
  52.                      Like the previous type, except that it  does
  53.                      not  create  an output file, so that section
  54.                      of the input file is effectively ignored.
  55.  
  56.               {_r_e_p_e_a_t_-_c_o_u_n_t}
  57.                      Repeat the previous pattern _r_e_p_e_a_t_-_c_o_u_n_t  (a
  58.                      positive integer) additional times.
  59.  
  60.        The  output  file  names consist of a prefix followed by a
  61.  
  62.  
  63.  
  64. FSF                     GNU Text Utilities                      1
  65.  
  66.  
  67.  
  68.  
  69.  
  70. CSPLIT(1L)                                             CSPLIT(1L)
  71.  
  72.  
  73.        number, so that concatenating the output files  in  sorted
  74.        order  by  file  name produces the original input file, in
  75.        order.  The default output file name prefix is `xx'.
  76.  
  77.        By default, if ccsspplliitt encounters an error  or  receives  a
  78.        hangup,  interrupt,  quit, or terminate signal, it removes
  79.        any output files that it has  created  so  far  before  it
  80.        exits.
  81.  
  82.    OOPPTTIIOONNSS
  83.        _-_f_, _-_-_p_r_e_f_i_x_=_p_r_e_f_i_x
  84.               Use _p_r_e_f_i_x as the output file name prefix.
  85.  
  86.        _-_k_, _-_-_k_e_e_p_-_f_i_l_e_s
  87.               Do not remove output files.
  88.  
  89.        _-_n_, _-_-_d_i_g_i_t_s_=_d_i_g_i_t_s
  90.               Use  output  file names containing numbers that are
  91.               _d_i_g_i_t_s digits long instead of the default 2.
  92.  
  93.        _-_s_, _-_-_s_i_l_e_n_t_, _-_-_q_u_i_e_t
  94.               Do not print counts of output file sizes.
  95.  
  96.        _-_-_h_e_l_p Print a usage message and exit with a non-zero sta-
  97.               tus.
  98.  
  99.        _-_-_v_e_r_s_i_o_n
  100.               Print  version  information  on standard error then
  101.               exit.
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130. FSF                     GNU Text Utilities                      2
  131.  
  132.  
  133.