~ubuntu-branches/ubuntu/utopic/coreutils/utopic-proposed

« back to all changes in this revision

Viewing changes to man/head.1

  • Committer: Colin Watson
  • Date: 2013-10-30 15:48:33 UTC
  • mfrom: (8.3.5 sid)
  • Revision ID: cjwatson@canonical.com-20131030154833-xdt6e1yfffqom1c4
merge from Debian 8.21-1

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
 
.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.35.
2
 
.TH HEAD "1" "October 2012" "GNU coreutils 8.20" "User Commands"
3
 
.SH NAME
4
 
head \- output the first part of files
5
 
.SH SYNOPSIS
6
 
.B head
7
 
[\fIOPTION\fR]... [\fIFILE\fR]...
8
 
.SH DESCRIPTION
9
 
.\" Add any additional description here
10
 
.PP
11
 
Print the first 10 lines of each FILE to standard output.
12
 
With more than one FILE, precede each with a header giving the file name.
13
 
With no FILE, or when FILE is \-, read standard input.
14
 
.PP
15
 
Mandatory arguments to long options are mandatory for short options too.
16
 
.TP
17
 
\fB\-c\fR, \fB\-\-bytes\fR=\fI[\-]K\fR
18
 
print the first K bytes of each file;
19
 
with the leading '\-', print all but the last
20
 
K bytes of each file
21
 
.TP
22
 
\fB\-n\fR, \fB\-\-lines\fR=\fI[\-]K\fR
23
 
print the first K lines instead of the first 10;
24
 
with the leading '\-', print all but the last
25
 
K lines of each file
26
 
.TP
27
 
\fB\-q\fR, \fB\-\-quiet\fR, \fB\-\-silent\fR
28
 
never print headers giving file names
29
 
.TP
30
 
\fB\-v\fR, \fB\-\-verbose\fR
31
 
always print headers giving file names
32
 
.TP
33
 
\fB\-\-help\fR
34
 
display this help and exit
35
 
.TP
36
 
\fB\-\-version\fR
37
 
output version information and exit
38
 
.PP
39
 
K may have a multiplier suffix:
40
 
b 512, kB 1000, K 1024, MB 1000*1000, M 1024*1024,
41
 
GB 1000*1000*1000, G 1024*1024*1024, and so on for T, P, E, Z, Y.
42
 
.SH AUTHOR
43
 
Written by David MacKenzie and Jim Meyering.
44
 
.SH "REPORTING BUGS"
45
 
Report head bugs to bug\-coreutils@gnu.org
46
 
.br
47
 
GNU coreutils home page: <http://www.gnu.org/software/coreutils/>
48
 
.br
49
 
General help using GNU software: <http://www.gnu.org/gethelp/>
50
 
.br
51
 
Report head translation bugs to <http://translationproject.org/team/>
52
 
.SH COPYRIGHT
53
 
Copyright \(co 2012 Free Software Foundation, Inc.
54
 
License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>.
55
 
.br
56
 
This is free software: you are free to change and redistribute it.
57
 
There is NO WARRANTY, to the extent permitted by law.
58
 
.SH "SEE ALSO"
59
 
The full documentation for
60
 
.B head
61
 
is maintained as a Texinfo manual.  If the
62
 
.B info
63
 
and
64
 
.B head
65
 
programs are properly installed at your site, the command
66
 
.IP
67
 
.B info coreutils \(aqhead invocation\(aq
68
 
.PP
69
 
should give you access to the complete manual.