home *** CD-ROM | disk | FTP | other *** search
/ Otherware / Otherware_1_SB_Development.iso / amiga / utility / misc / textutil.lha / textutils-1.3 / cat / csplit.1 < prev    next >
Encoding:
Text File  |  1992-09-22  |  3.7 KB  |  133 lines
  1.  
  2.  
  3.  
  4. CSPLIT(1L)        MISC. REFERENCE MANUAL PAGES         CSPLIT(1L)
  5.  
  6.  
  7.  
  8. NAME
  9.      csplit - split a file into sections  determined  by  context
  10.      lines
  11.  
  12. SYNOPSIS
  13.      csplit  [-sk]  [-f  prefix]  [-n  digits]  [--prefix=prefix]
  14.      [--digits=digits]  [--quiet]  [--silent] [--keep-files] file
  15.      pattern...
  16.  
  17. DESCRIPTION
  18.      This manual  page  documents  the  GNU  version  of  csplit.
  19.      csplit creates zero or more output files containing sections
  20.      of the given input _f_i_l_e, or the standard input if  the  name
  21.      `-' is given.  By default, csplit prints the number of bytes
  22.      written to each output file after it has been created.
  23.  
  24.      The contents of the output files are determined by the  _p_a_t_-
  25.      _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.  The
  28.      types of pattern arguments are:
  29.  
  30.           _l_i_n_e
  31.                Create an output file containing the current  line
  32.                up  to  (but  not including) line _l_i_n_e (a positive
  33.                integer) of the input  file.   If  followed  by  a
  34.                repeat  count, also create an output file contain-
  35.                ing the next _l_i_n_e lines of the input file once for
  36.                each repeat.
  37.  
  38.           /_r_e_g_e_x_p/[_o_f_f_s_e_t]
  39.                Create an output file containing the current  line
  40.                up  to  (but  not  including) the next line of the
  41.                input file that contains a match for _r_e_g_e_x_p.   The
  42.                optional  _o_f_f_s_e_t  is  a  `+'  or `-' followed by a
  43.                positive integer; if it is given,  the  line  that
  44.                starts  the  next section of the input file is the
  45.                line that contains the match for _r_e_g_e_x_p  plus  the
  46.                offset.
  47.  
  48.           %_r_e_g_e_x_p%[_o_f_f_s_e_t]
  49.                Like the previous type, except that  it  does  not
  50.                create  an  output  file,  so  that section of the
  51.                input file is effectively ignored.
  52.  
  53.           {_r_e_p_e_a_t-_c_o_u_n_t}
  54.                Repeat the previous pattern _r_e_p_e_a_t-_c_o_u_n_t (a  posi-
  55.                tive integer) additional times.
  56.  
  57.      The output file names consist of  a  prefix  followed  by  a
  58.      number,  so  that  concatenating  the output files in sorted
  59.      order by file name produces  the  original  input  file,  in
  60.  
  61.  
  62.  
  63. Sun Release 4.1           Last change:                          1
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. CSPLIT(1L)        MISC. REFERENCE MANUAL PAGES         CSPLIT(1L)
  71.  
  72.  
  73.  
  74.      order.  The default output file name prefix is `xx'.
  75.  
  76.      By default, if csplit encounters  an  error  or  receives  a
  77.      hangup, interrupt, quit, or terminate signal, it removes any
  78.      output files that it has created so far before it exits.
  79.  
  80.   OPTIONS
  81.      -_f, --_p_r_e_f_i_x=_p_r_e_f_i_x
  82.           Use _p_r_e_f_i_x as the output file name prefix.
  83.  
  84.      -_k, --_k_e_e_p-_f_i_l_e_s
  85.           Do not remove output files.
  86.  
  87.      -_n, --_d_i_g_i_t_s=_d_i_g_i_t_s
  88.           Use output  file  names  containing  numbers  that  are
  89.           _d_i_g_i_t_s digits long instead of the default 2.
  90.  
  91.      -_s, --_s_i_l_e_n_t, --_q_u_i_e_t
  92.           Do not print counts of output file sizes.
  93.  
  94.      The long-named options can be introduced with `+' as well as
  95.      `--',  for compatibility with previous releases.  Eventually
  96.      support for `+' will be removed, because it is  incompatible
  97.      with the POSIX.2 standard.
  98.  
  99.  
  100.  
  101.  
  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. Sun Release 4.1           Last change:                          2
  130.  
  131.  
  132.  
  133.