pd.if.org Git - pdutils/blob - posix/head/head.1

   1 .TH HEAD 1 "2008-1.01" "pdcore utilities" "User Commands"
   2 .SH NAME
   3 head \- copy the first part of files
   4 .SH SYNOPSIS
   5 .B head
   6 [-n number] [file ...]
   7 .SH DESCRIPTION
   8 Copy the first 'number' lines of the input files to standard output.
   9 .SH OPTIONS
  10 .TP
  11 -n number
  12 Where 'number' is a positive integer indicating the number of lines to copy.
  13 If omitted, head will default to copying the first 10 lines of input.
  14 .SH OPERANDS
  15 .TP
  16 file
  17 Input file(s). If none provided, or the filename '-' is passed to head,
  18 standard input will be used.
  19 .SH NOTES
  20 Prior versions of head allowed '-x' as an option, with 'x' representing
  21 the number of lines to be copied. The equivalent acceptable syntax is
  22 now '-n x'.
  23 .SH "AUTHORITATIVE DOCUMENTATION"
  24 <http://www.opengroup.org/onlinepubs/9699919799/utilities/head.html>
  25 .SH VERSION AND COMPLIANCE
  26 Utility version 1.01
  27 .P
  28 Functional compliance with POSIX:2008 (IEEE Std 1003.1-2008;
  29 Shell and Utilities, Base Specifications Issue 7).
  30 .SH UNLICENSE
  31 This is free and unencumbered software released into the public domain,
  32 provided "as is", without warranty of any kind, express or implied. See the
  33 file UNLICENSE and the website <http://unlicense.org> for further details.