home *** CD-ROM | disk | FTP | other *** search
/ Dream 51 / Amiga_Dream_51.iso / Atari / Desktops / text113b.zoo / textutils-1.13 / man / split.1 < prev    next >
Text File  |  1996-01-21  |  3KB  |  133 lines
  1.  
  2.  
  3.  
  4. SPLIT(1)                                                 SPLIT(1)
  5.  
  6.  
  7. NNAAMMEE
  8.        split - split a file into pieces
  9.  
  10. SSYYNNOOPPSSIISS
  11.        sspplliitt  [-lines] [-l lines] [-b bytes[bkm]] [-C bytes[bkm]]
  12.        [--lines=lines]       [--bytes=bytes[bkm]]        [--line-
  13.        bytes=bytes[bkm]]  [--help]  [--version] [infile [outfile-
  14.        prefix]]
  15.  
  16. DDEESSCCRRIIPPTTIIOONN
  17.        This manual page  documents  the  GNU  version  of  sspplliitt.
  18.        sspplliitt  creates one or more output files (as many as neces-
  19.        sary) containing consecutive sections of  the  _i_n_f_i_l_e,  or
  20.        the  standard  input  if  none is given or the name `-' is
  21.        given.  By default, sspplliitt puts 1000  lines  of  the  input
  22.        file,  or  whatever  is left if it is less than that, into
  23.        each output file.
  24.  
  25.        The output file names consist of a prefix  followed  by  a
  26.        group  of letters, chosen so that concatenating the output
  27.        files in sorted order by file name produces  the  original
  28.        input file, in order.  The default output file name prefix
  29.        is `x'.  If the _o_u_t_f_i_l_e_-_p_r_e_f_i_x argument is  given,  it  is
  30.        used as the output file name prefix instead.
  31.  
  32.    OOPPTTIIOONNSS
  33.        _-_l_i_n_e_s_, _-_l _l_i_n_e_s_, _-_-_l_i_n_e_s_=_l_i_n_e_s
  34.               Put  _l_i_n_e_s lines of the input file into each output
  35.               file.
  36.  
  37.        _-_b _b_y_t_e_s_[_b_k_m_]_, _-_-_b_y_t_e_s_=_b_y_t_e_s_[_b_k_m_]
  38.               Put _b_y_t_e_s bytes of the input file into each  output
  39.               file.   _b_y_t_e_s is a nonzero integer, optionally fol-
  40.               lowed by one of the following characters to specify
  41.               a different unit.
  42.  
  43.               b      512-byte blocks.
  44.  
  45.               k      1-kilobyte blocks.
  46.  
  47.               m      1-megabyte blocks.
  48.  
  49.        _-_C _b_y_t_e_s_[_b_k_m_]_, _-_-_l_i_n_e_-_b_y_t_e_s_=_b_y_t_e_s_[_b_k_m_]
  50.               Put into each output file as many complete lines of
  51.               the input file as  is  possible  without  exceeding
  52.               _b_y_t_e_s  bytes.   If a line that is longer than _b_y_t_e_s
  53.               bytes occurs, put _b_y_t_e_s bytes of it into each  out-
  54.               put  file  until  less than _b_y_t_e_s bytes of the line
  55.               are left, then continue normally.   _b_y_t_e_s  has  the
  56.               same format as for the _-_-_b_y_t_e_s option.
  57.  
  58.        _-_-_h_e_l_p Print  a  usage message and exit with a status code
  59.               indicating success.
  60.  
  61.  
  62.  
  63.  
  64. FSF                     GNU Text Utilities                      1
  65.  
  66.  
  67.  
  68.  
  69.  
  70. SPLIT(1)                                                 SPLIT(1)
  71.  
  72.  
  73.        _-_-_v_e_r_s_i_o_n
  74.               Print version information on standard  output  then
  75.               exit.
  76.  
  77.  
  78.  
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  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.  
  130. FSF                     GNU Text Utilities                      2
  131.  
  132.  
  133.