home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 22 gnu / 22-gnu.zip / GNUTUE.ZIP / man / split.man < prev    next >
Text File  |  1992-07-18  |  2KB  |  48 lines
  1. NAME
  2.      split - split a file into pieces
  3.  
  4. SYNOPSIS
  5.      split [-lines] [-l lines] [-b bytes[bkm]] [-C bytes[bkm]] [--lines=lines]
  6.      [--bytes=bytes[bkm]] [--line-bytes=bytes[bkm]] [infile [outfile-prefix]]
  7.  
  8. DESCRIPTION
  9.      This manual page documents the GNU version of split.  split  creates  one
  10.      or  more  output  files  (as  many  as  necessary) containing consecutive
  11.      sections of the infile, or the standard input if none  is  given  or  the
  12.      name  `-' is given.  By default, split puts 1000 lines of the input file,
  13.      or whatever is left if it is less than that, into each output file.
  14.  
  15.      The output file names consist of a prefix followed by a group of letters,
  16.      chosen  so  that  concatenating  the output files in sorted order by file
  17.      name produces the original input file, in order.  The default output file
  18.      name  prefix is `x'.  If the outfile-prefix argument is given, it is used
  19.      as the output file name prefix instead.
  20.  
  21.      OPTIONS
  22.  
  23.      -lines, -l lines, --lines=lines
  24.           Put lines lines of the input file into each output file.
  25.  
  26.      -b bytes[bkm], --bytes=bytes[bkm]
  27.           Put bytes bytes of the input file into each output file.  bytes is a
  28.           nonzero  integer,  optionally  followed  by  one  of  the  following
  29.           characters to specify a different unit.
  30.  
  31.      b    512-byte blocks.
  32.  
  33.      k    1-kilobyte blocks.
  34.  
  35.      m    1-megabyte blocks.
  36.  
  37.      -C bytes[bkm], --line-bytes=bytes[bkm]
  38.           Put into each output file as many complete lines of the  input  file
  39.           as  is  possible  without  exceeding bytes bytes.  If a line that is
  40.           longer than bytes bytes occurs, put bytes  bytes  of  it  into  each
  41.           output  file  until less than bytes bytes of the line are left, then
  42.           continue normally.  bytes has the same format  as  for  the  --bytes
  43.           option.
  44.  
  45.      The long-named options can be introduced with `+' as well  as  `--',  for
  46.      compatibility with previous releases.  Eventually support for `+' will be
  47.      removed, because it is incompatible with the POSIX.2 standard.
  48.