1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
|
'\" te
.\" Copyright (c) 1999, Sun Microsystems, Inc. All Rights Reserved
.\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License.
.\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License.
.\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
.TH XGETTEXT 1 "Mar 23, 1999"
.SH NAME
xgettext \- extract gettext call strings from C programs
.SH SYNOPSIS
.LP
.nf
\fBxgettext\fR [\fB-ns\fR] [\fB-a\fR [\fB-x\fR \fIexclude-file\fR]] [\fB-c\fR \fIcomment-tag\fR]
[\fB-d\fR \fIdefault-domain\fR] [\fB-j\fR] [\fB-m\fR \fIprefix\fR] [\fB-M\fR \fIsuffix\fR]
[\fB-p\fR \fIpathname\fR] \fB-|\fR \fIfilename\fR...
.fi
.LP
.nf
\fBxgettext\fR \fB-h\fR
.fi
.SH DESCRIPTION
.sp
.LP
The \fBxgettext\fR utility is used to automate the creation of portable message
files (\fB\&.po\fR). A \fB\&.po\fR file contains copies of "C" strings that are
found in ANSI C source code in \fIfilename\fR or the standard input if
`\fB\(mi\fR\&' is specified on the command line. The \fB\&.po\fR file can be
used as input to the \fBmsgfmt\fR(1) utility, which produces a binary form of
the message file that can be used by application during run-time.
.sp
.LP
\fBxgettext\fR writes \fImsgid\fR strings from \fBgettext\fR(3C) calls in
\fIfilename\fR to the default output file \fBmessages.po\fR. The default output
file name can be changed by \fB-d\fR option. \fImsgid\fR strings in
\fBdgettext()\fR calls are written to the output file
\fBdomainname\fR\fB\&.po\fR where \fBdomainname\fR is the first parameter to
the \fBdgettext()\fR call.
.sp
.LP
By default, \fBxgettext\fR creates a \fB\&.po\fR file in the current working
directory, and each entry is in the same order that the strings are extracted
from \fIfilenames\fR. When the \fB-p\fR option is specified, the \fB\&.po\fR
file is created in the \fIpathname\fR directory. An existing \fB\&.po\fR file
is overwritten.
.sp
.LP
Duplicate \fImsgid\fRs are written to the \fB\&.po\fR file as comment lines.
When the \fB-s\fR option is specified, the \fB\&.po\fR is sorted by the
\fImsgid\fR string, and all duplicated \fImsgid\fRs are removed. All
\fImsgstr\fR directives in the \fB\&.po\fR file are empty unless the \fB-m\fR
option is used.
.SH OPTIONS
.sp
.LP
The following options are supported:
.sp
.ne 2
.na
\fB\fB-n\fR\fR
.ad
.RS 21n
Add comment lines to the output file indicating file name and line number in
the source file where each extracted string is encountered. These lines appear
before each \fImsgid\fR in the following format:
.sp
.in +2
.nf
# # File: \fIfilename\fR, line: \fIline-number\fR
.fi
.in -2
.sp
.RE
.sp
.ne 2
.na
\fB\fB-s\fR\fR
.ad
.RS 21n
Generate output sorted by \fImsgid\fRs with all duplicate \fImsgid\fRs
removed.
.RE
.sp
.ne 2
.na
\fB\fB-a\fR\fR
.ad
.RS 21n
Extract all strings, not just those found in \fBgettext\fR(3C), and
\fBdgettext()\fR () calls. Only one \fB\&.po\fR file is created.
.RE
.sp
.ne 2
.na
\fB\fB-c\fR \fIcomment-tag\fR\fR
.ad
.RS 21n
The comment block beginning with \fIcomment-tag\fR as the first token of the
comment block is added to the output \fB\&.po\fR file as \fI#\fR delimited
comments. For multiple domains, \fBxgettext\fR directs comments and messages to
the prevailing text domain.
.RE
.sp
.ne 2
.na
\fB\fB-d\fR \fIdefault-domain\fR\fR
.ad
.RS 21n
Rename default output file from \fBmessages.po\fR to \fIdefault-domain\fR
\fB\&.po\fR.
.RE
.sp
.ne 2
.na
\fB\fB-j\fR\fR
.ad
.RS 21n
Join messages with existing message files. If a \fB\&.po\fR file does not
exist, it is created. If a \fB\&.po\fR file does exist, new messages are
appended. Any duplicate \fBmsgid\fRs are commented out in the resulting
\fB\&.po\fR file. Domain directives in the existing \fB\&.po\fR file are
ignored. Results not guaranteed if the existing message file has been edited.
.RE
.sp
.ne 2
.na
\fB\fB-m\fR \fIprefix\fR\fR
.ad
.RS 21n
Fill in the \fImsgstr\fR with \fIprefix\fR. This is useful for debugging
purposes. To make \fImsgstr\fR identical to \fImsgid\fR, use an empty string
(\fB""\fR) for \fIprefix\fR.
.RE
.sp
.ne 2
.na
\fB\fB-M\fR \fIsuffix\fR\fR
.ad
.RS 21n
Fill in the \fImsgstr\fR with \fIsuffix\fR. This is useful for debugging
purposes.
.RE
.sp
.ne 2
.na
\fB\fB-p\fR \fIpathname\fR\fR
.ad
.RS 21n
Specify the directory where the output files will be placed. This option
overrides the current working directory.
.RE
.sp
.ne 2
.na
\fB\fB-x\fR \fIexclude-file\fR\fR
.ad
.RS 21n
Specify a \fB\&.po\fR file that contains a list of \fImsgid\fRs that are not
to be extracted from the input files. The format of \fIexclude-file\fR is
identical to the \fB\&.po\fR file. However, only the \fImsgid\fR directive line
in \fIexclude-file\fR is used. All other lines are simply ignored. The
\fB-x\fR option can only be used with the \fB-a\fR option.
.RE
.sp
.ne 2
.na
\fB\fB-h\fR\fR
.ad
.RS 21n
Print a help message on the standard output.
.RE
.SH SEE ALSO
.sp
.LP
.BR msgfmt (1),
.BR gettext (3C),
.BR attributes (7)
.SH NOTES
.sp
.LP
\fBxgettext\fR is not able to extract cast strings, for example ANSI C casts of
literal strings to \fB(const char *)\fR. This is unnecessary anyway, since the
prototypes in \fB<libintl.h>\fR already specify this type.
.sp
.LP
In messages and translation notes, lines greater than 2048 characters are
truncated to 2048 characters and a warning message is printed to stderr.
|
