home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 22 gnu / 22-gnu.zip / GNUTUE.ZIP / man / head.man < prev    next >
Text File  |  1992-07-18  |  2KB  |  46 lines
  1. NAME
  2.      head - output the first part of files
  3.  
  4. SYNOPSIS
  5.      head [-c N[bkm]] [-n  N]  [-qv]  [--bytes=N[bkm]]  [--lines=N]  [--quiet]
  6.      [--silent] [--verbose] [file...]
  7.  
  8.      head [-Nbcklmqv] [file...]
  9.  
  10. DESCRIPTION
  11.      This manual page documents the GNU version  of  head.   head  prints  the
  12.      first  part  (10  lines  by  default)  of  each given file; it reads from
  13.      standard input if no files are  given  or  when  a  filename  of  `-'  is
  14.      encountered.   If  more  than  one  file  is  given,  it  prints a header
  15.      consisting of the file's name enclosed in  `==>'  and  `<=='  before  the
  16.      output for each file.
  17.  
  18.      OPTIONS
  19.  
  20.      head accepts two option formats:  the  new  one,  in  which  numbers  are
  21.      arguments  to  the  option  letters, and the old one, in which the number
  22.      precedes any option letters.
  23.  
  24.      -c N, --bytes N
  25.           Print first N bytes.  N is a nonzero integer, optionally followed by
  26.           one of the following characters to specify a different unit.
  27.  
  28.      b    512-byte blocks.
  29.  
  30.      k    1-kilobyte blocks.
  31.  
  32.      m    1-megabyte blocks.
  33.  
  34.      -l, -n N, --lines N
  35.           Print first N lines.
  36.  
  37.      -q, --quiet, --silent
  38.           Never print filename headers.
  39.  
  40.      -v, --verbose
  41.           Always print filename headers.
  42.  
  43.      The long-named options can be introduced with `+' as well  as  `--',  for
  44.      compatibility with previous releases.  Eventually support for `+' will be
  45.      removed, because it is incompatible with the POSIX.2 standard.
  46.