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

« back to all changes in this revision

Viewing changes to man/printf.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 PRINTF "1" "October 2012" "GNU coreutils 8.20" "User Commands"
3
 
.SH NAME
4
 
printf \- format and print data
5
 
.SH SYNOPSIS
6
 
.B printf
7
 
\fIFORMAT \fR[\fIARGUMENT\fR]...
8
 
.br
9
 
.B printf
10
 
\fIOPTION\fR
11
 
.SH DESCRIPTION
12
 
.\" Add any additional description here
13
 
.PP
14
 
Print ARGUMENT(s) according to FORMAT, or execute according to OPTION:
15
 
.TP
16
 
\fB\-\-help\fR
17
 
display this help and exit
18
 
.TP
19
 
\fB\-\-version\fR
20
 
output version information and exit
21
 
.PP
22
 
FORMAT controls the output as in C printf.  Interpreted sequences are:
23
 
.TP
24
 
\e"
25
 
double quote
26
 
.TP
27
 
\e\e
28
 
backslash
29
 
.TP
30
 
\ea
31
 
alert (BEL)
32
 
.TP
33
 
\eb
34
 
backspace
35
 
.TP
36
 
\ec
37
 
produce no further output
38
 
.TP
39
 
\ee
40
 
escape
41
 
.TP
42
 
\ef
43
 
form feed
44
 
.TP
45
 
\en
46
 
new line
47
 
.TP
48
 
\er
49
 
carriage return
50
 
.TP
51
 
\et
52
 
horizontal tab
53
 
.TP
54
 
\ev
55
 
vertical tab
56
 
.TP
57
 
\eNNN
58
 
byte with octal value NNN (1 to 3 digits)
59
 
.TP
60
 
\exHH
61
 
byte with hexadecimal value HH (1 to 2 digits)
62
 
.TP
63
 
\euHHHH
64
 
Unicode (ISO/IEC 10646) character with hex value HHHH (4 digits)
65
 
.TP
66
 
\eUHHHHHHHH
67
 
Unicode character with hex value HHHHHHHH (8 digits)
68
 
.TP
69
 
%%
70
 
a single %
71
 
.TP
72
 
%b
73
 
ARGUMENT as a string with '\e' escapes interpreted,
74
 
except that octal escapes are of the form \e0 or \e0NNN
75
 
.PP
76
 
and all C format specifications ending with one of diouxXfeEgGcs, with
77
 
ARGUMENTs converted to proper type first.  Variable widths are handled.
78
 
.PP
79
 
NOTE: your shell may have its own version of printf, which usually supersedes
80
 
the version described here.  Please refer to your shell's documentation
81
 
for details about the options it supports.
82
 
.SH AUTHOR
83
 
Written by David MacKenzie.
84
 
.SH "REPORTING BUGS"
85
 
Report printf bugs to bug\-coreutils@gnu.org
86
 
.br
87
 
GNU coreutils home page: <http://www.gnu.org/software/coreutils/>
88
 
.br
89
 
General help using GNU software: <http://www.gnu.org/gethelp/>
90
 
.br
91
 
Report printf translation bugs to <http://translationproject.org/team/>
92
 
.SH COPYRIGHT
93
 
Copyright \(co 2012 Free Software Foundation, Inc.
94
 
License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>.
95
 
.br
96
 
This is free software: you are free to change and redistribute it.
97
 
There is NO WARRANTY, to the extent permitted by law.
98
 
.SH "SEE ALSO"
99
 
printf(3)
100
 
.PP
101
 
The full documentation for
102
 
.B printf
103
 
is maintained as a Texinfo manual.  If the
104
 
.B info
105
 
and
106
 
.B printf
107
 
programs are properly installed at your site, the command
108
 
.IP
109
 
.B info coreutils \(aqprintf invocation\(aq
110
 
.PP
111
 
should give you access to the complete manual.