OSDN Git Service

Update translations: chroot, csplit, dd, du, pwd
[linuxjm/coreutils.git] / original / man1 / printf.1
1 .\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.47.3.
2 .TH PRINTF "1" "January 2016" "GNU coreutils 8.25" "User Commands"
3 .SH NAME
4 printf \- format and print data
5 .SH SYNOPSIS
6 .B printf
7 \fI\,FORMAT \/\fR[\fI\,ARGUMENT\/\fR]...
8 .br
9 .B printf
10 \fI\,OPTION\/\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 .TP
76 %q
77 ARGUMENT is printed in a format that can be reused as shell input,
78 escaping non\-printable characters with the proposed POSIX $'' syntax.
79 .PP
80 and all C format specifications ending with one of diouxXfeEgGcs, with
81 ARGUMENTs converted to proper type first.  Variable widths are handled.
82 .PP
83 NOTE: your shell may have its own version of printf, which usually supersedes
84 the version described here.  Please refer to your shell's documentation
85 for details about the options it supports.
86 .SH AUTHOR
87 Written by David MacKenzie.
88 .SH "REPORTING BUGS"
89 GNU coreutils online help: <http://www.gnu.org/software/coreutils/>
90 .br
91 Report printf translation bugs to <http://translationproject.org/team/>
92 .SH COPYRIGHT
93 Copyright \(co 2016 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 .br
102 Full documentation at: <http://www.gnu.org/software/coreutils/printf>
103 .br
104 or available locally via: info \(aq(coreutils) printf invocation\(aq