head
                                   ----
            Documentation for version 1.0, on August 13th, 1991

                              by Bruno Costa


WARNING

  Although  this  program  is freely distributable (see COPYRIGHT below), I
would  appreciate  if  you  take the time to write me a line or two (E-Mail
please)  if  you  are  using  any of my programs or if you have any kind of
ideas  or  suggestions  (This is not too much to ask, is it?).  If you feel
particularly  generous,  I  would  like  to  receive a disk with any useful
programs you have written, preferrably with source.  Thanks!


DESCRIPTION

  Head  is  a  simple utility that outputs just a few of the first lines of
any file.  Is just like the type command of AmigaDOS, but it types just the
first  lines  of  files.   It may be used to peek at the contents of a text
file  without  having to edit or type the entire file.  It works both under
WB1.3 and WB2.0.


OPTIONS

  usage: head [-?] [-<nlines>] [files ...]

  The  option  '?'  prints  just a usage message to stderr.  The '<nlines>'
option allows the user to determine how many of the first lines of the file
will be printed (defaults to 10).

  If  run  without  any  file  name in the command line, head will show the
first 10 lines of stdin.


EXAMPLES

  to see the first 10 lines of your startup-sequence:
    head s:startup-sequence

  to see the first 24 lines of the standard input:
    head -24


BUGS

  The  maximum  line  lenght is limited to 128 characters (it can be easily
changed in the source code).


AUTHOR

  The  accompanying  program  and  this documentation were written by Bruno
Costa.  He can be reached in the following ways:

  E-Mail: bruno@brlncc.bitnet (InterNet)
          bruno@BRLNCC        (BitNet)

  Mail:   Bruno Costa
          Rua Almirante Guilhem 454/102 bloco 1
          Leblon - Rio de Janeiro
          RJ 22440
          BRAZIL


COPYRIGHT

  This program is copyrighted by Bruno Costa.  It may be freely distributed
if  and  only if the source code, the documentation and the executables are
provided  in  original form.  It may be included in Public Domain/Shareware
compilations,  like  the  one  organized  by  Fred  Fish, as long as just a
nominal fee is charged for each disk (no more than US$10 per disk), and may
also be uploaded to BBS's or network services like BIX and CompuServe.


DISCLAIMER

  The author makes no warranty of any kind with respect to this product and
explicitly  disclaims  any implied warranties of merchantability or fitness
for  any  particular  purpose.