Debian Codegraph @

upstream/debian-unstable/man1/printf_gettext.1

raw
1 .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.47.6.
2 .TH PRINTF_GETTEXT "1" "July 2025" "GNU gettext-runtime 0.26" "User Commands"
3 .SH NAME
4 printf_gettext \- translate format string and apply it
5 .SH SYNOPSIS
6 .B printf_gettext
7 [\fI\,OPTION\/\fR] \fI\,FORMAT \/\fR[\fI\,ARGUMENT\/\fR]...
8 .SH DESCRIPTION
9 .\" Add any additional description here
10 The \fBprintf_gettext\fP program translates a format string into the user's
11 language, by looking up the translation in a message catalog, and applies
12 the translated format string to the specified arguments.
13 .PP
14 Produces formatted output, applying the native language translation of FORMAT
15 to the ARGUMENTs.
16 .SS "Options and arguments:"
17 .TP
18 \fB\-c\fR, \fB\-\-context\fR=\fI\,CONTEXT\/\fR
19 specify context for FORMAT
20 .TP
21 FORMAT
22 format string
23 .TP
24 ARGUMENT
25 string or numeric argument
26 .SS "Informative output:"
27 .TP
28 \fB\-h\fR, \fB\-\-help\fR
29 display this help and exit
30 .TP
31 \fB\-V\fR, \fB\-\-version\fR
32 display version information and exit
33 .PP
34 The format string consists of
35 .IP
36 \- plain text,
37 \- directives, that start with '%',
38 \- escape sequences, that start with a backslash.
39 .PP
40 A directive that consumes an argument
41 .IP
42 \- starts with '%' or '%m$' where m is a positive integer,
43 \- is optionally followed by any of the characters '#', '0', '\-', ' ', '+',
44 .IP
45 each of which acts as a flag,
46 .IP
47 \- is optionally followed by a width specification (a nonnegative integer),
48 \- is optionally followed by '.' and a precision specification (an optional
49 .IP
50 nonnegative integer),
51 .IP
52 \- is finished by a specifier
53 .IP
54 \- 'c', that prints a character,
55 \- 's', that prints a string,
56 \- 'i', 'd', that print an integer,
57 \- 'u', 'o', 'x', 'X', that print an unsigned (nonnegative) integer,
58 \- 'e', 'E', that print a floating\-point number in scientific notation,
59 \- 'f', 'F', that print a floating\-point number without an exponent,
60 \- 'g', 'G', that print a floating\-point number in general notation,
61 \- 'a', 'A', that print a floating\-point number in hexadecimal notation.
62 .PP
63 Additionally there is the directive '%%', that prints a single '%'.
64 .PP
65 If a directive specifies the argument by its number ('%m$' notation),
66 all directives that consume an argument must do so.
67 .PP
68 The escape sequences are:
69 .TP
70 \e\e
71 backslash
72 .TP
73 \ea
74 alert (BEL)
75 .TP
76 \eb
77 backspace (BS)
78 .TP
79 \ef
80 form feed (FF)
81 .TP
82 \en
83 new line (LF)
84 .TP
85 \er
86 carriage return (CR)
87 .TP
88 \et
89 horizontal tab (HT)
90 .TP
91 \ev
92 vertical tab (VT)
93 .TP
94 \ennn
95 octal number with 1 to 3 octal digits
96 .PP
97 Environment variables:
98 .PP
99 The translation of the format string is looked up in the translation domain
100 given by the environment variable TEXTDOMAIN.
101 It is looked up in the catalogs directory given by the environment variable
102 TEXTDOMAINDIR or, if not present, in the default catalogs directory.
103 This binary is configured to use the default catalogs directory:
104 /usr/share/locale
105 .SH AUTHOR
106 Written by Bruno Haible.
107 .SH "REPORTING BUGS"
108 Report bugs in the bug tracker at <https://savannah.gnu.org/projects/gettext>
109 or by email to <bug\[email protected]>.
110 .SH COPYRIGHT
111 Copyright \(co 2025 Free Software Foundation, Inc.
112 License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>
113 .br
114 This is free software: you are free to change and redistribute it.
115 There is NO WARRANTY, to the extent permitted by law.
116 .SH "SEE ALSO"
117 The full documentation for
118 .B printf_gettext
119 is maintained as a Texinfo manual. If the
120 .B info
121 and
122 .B printf_gettext
123 programs are properly installed at your site, the command
124 .IP
125 .B info printf_gettext
126 .PP
127 should give you access to the complete manual.