src/usr.bin/head/head.1 - diff

Return to head.1 CVS log

Up to [local] / src / usr.bin / head

Diff for /src/usr.bin/head/head.1 between version 1.3 and 1.4

-version 1.3, 1999/06/05 01:21:27
+version 1.4, 1999/07/21 13:19:20
 Line 37
 Line 37
 Line 37
  .Os
  .Sh NAME
  .Nm head
- .Nd give first few lines
+ .Nd display first few lines of files
  .Sh SYNOPSIS
  .Nm head
- .Op Fl n Ar count
+ .Oo
+ .Fl Ns Ar count No \&|
+ .Fl n Ar count
+ .Oc
  .Op Ar
  .Sh DESCRIPTION
- This filter copies the first
+ The
+ .Nm
+ utility copies the first
  .Ar count
- lines of each of the specified files, or of the standard input.
+ lines of each specified
+ .Ar file
+ to the standard output.
+ If no
+ .Ar file
+ is given,
+ .Nm
+ copies lines from the standard input.
  If
  .Ar count
- is omitted it defaults to
+ is omitted, it defaults to 10.
-.
+ .Pp
+ The options are as follows:
+ .Pp
+ .Bl -tag -width Ds
+ .It Xo Fl Ns Ar count No \&|
+ .Fl n Ar count
+ .Xc
+ Copy the first
+ .Ar count
+ lines of each input file to the standard output.
+ .Ar count
+ must be a positive decimal integer.
+ .El
+ .Pp
+ If more than one file is specified,
+ .Nm
+ precedes the output of each file with the following, in order to distinguish
+ the head of each file:
+ .Pp
+ .Dl ==> Ar file No <==
+ .Sh EXAMPLES
+ To display the first 500 lines of the file
+ .Ar foo :
+ .Pp
+ .Dl $ head -500 foo
+ .Pp
+ .Nm
+ can be used in conjunction with
+ .Xr tail 1
+ in the following way to, for example, display only line 500 from the file
+ .Ar foo :
+ .Pp
+ .Dl $ head -500 foo | tail -1
  .Sh COMPATIBILITY
  The historic command line syntax of
  .Nm
  is supported by this implementation.
  .Sh SEE ALSO
+ .Xr cat 1 ,
+ .Xr less 1 ,
+ .Xr more 1 ,
  .Xr tail 1
  .Sh STANDARDS
  The