source: BOOK/final-system/common/gettext.xml@ 93aa336

clfs-1.2 clfs-2.1 clfs-3.0.0-systemd clfs-3.0.0-sysvinit systemd sysvinit
Last change on this file since 93aa336 was 93aa336, checked in by Jim Gifford <clfs@…>, 19 years ago

r669@server (orig r667): manuel | 2005-11-08 15:43:49 -0800
Finished SBUs and DUs removal.

  • Property mode set to 100644
File size: 13.6 KB
Line 
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
3 "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
4 <!ENTITY % general-entities SYSTEM "../../general.ent">
5 <!ENTITY % patches-entities SYSTEM "../../patches.ent">
6 %general-entities;
7 %patches-entities;
8]>
9
10<sect1 id="ch-system-gettext" role="wrap">
11 <?dbhtml filename="gettext.html"?>
12
13 <title>Gettext-&gettext-version;</title>
14
15 <indexterm zone="ch-system-gettext">
16 <primary sortas="a-Gettext">Gettext</primary>
17 </indexterm>
18
19 <sect2 role="package">
20 <title/>
21
22 <para>The Gettext package contains utilities for internationalization
23 and localization. These allow programs to be compiled with NLS (Native
24 Language Support), enabling them to output messages in the user's native
25 language.</para>
26
27 <segmentedlist>
28 <segtitle>&dependencies;</segtitle>
29
30 <seglistitem>
31 <seg>Bash, Binutils, Bison, Coreutils, Diffutils, Gawk,
32 GCC, Glibc, Grep, Make, and Sed</seg>
33 </seglistitem>
34 </segmentedlist>
35
36 </sect2>
37
38 <sect2 role="installation">
39 <title>Installation of Gettext</title>
40
41 <para>Prepare Gettext for compilation:</para>
42
43<screen><userinput>./configure --prefix=/usr</userinput></screen>
44
45 <para>Compile the package:</para>
46
47<screen><userinput>make</userinput></screen>
48
49 <para>To test the results, issue: <userinput>make check</userinput>.</para>
50
51 <para>Install the package:</para>
52
53<screen><userinput>make install</userinput></screen>
54
55 </sect2>
56
57 <sect2 id="contents-gettext" role="content">
58 <title>Contents of Gettext</title>
59
60 <segmentedlist>
61 <segtitle>Installed programs</segtitle>
62 <segtitle>Installed libraries</segtitle>
63
64 <seglistitem>
65 <seg>autopoint, config.charset, config.rpath, envsubst, gettext,
66 gettextize, hostname, msgattrib, msgcat, msgcmp, msgcomm, msgconv, msgen,
67 msgexec, msgfilter, msgfmt, msggrep, msginit, msgmerge, msgunfmt, msguniq,
68 ngettext, and xgettext</seg>
69 <seg>libasprintf.[a,so], libgettextlib,so, libgettextpo.[a,so], and
70 libgettextsrc,so</seg>
71 </seglistitem>
72 </segmentedlist>
73
74 <variablelist>
75 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
76 <?dbfo list-presentation="list"?>
77 <?dbhtml list-presentation="table"?>
78
79 <varlistentry id="autopoint">
80 <term><command>autopoint</command></term>
81 <listitem>
82 <para>Copies standard Gettext infrastructure files into a source
83 package</para>
84 <indexterm zone="ch-system-gettext autopoint">
85 <primary sortas="b-autopoint">autopoint</primary>
86 </indexterm>
87 </listitem>
88 </varlistentry>
89
90 <varlistentry id="config.charset">
91 <term><command>config.charset</command></term>
92 <listitem>
93 <para>Outputs a system-dependent table of character encoding
94 aliases</para>
95 <indexterm zone="ch-system-gettext config.charset">
96 <primary sortas="b-config.charset">config.charset</primary>
97 </indexterm>
98 </listitem>
99 </varlistentry>
100
101 <varlistentry id="config.rpath">
102 <term><command>config.rpath</command></term>
103 <listitem>
104 <para>Outputs a system-dependent set of variables, describing how
105 to set the runtime search path of shared libraries in an
106 executable</para>
107 <indexterm zone="ch-system-gettext config.rpath">
108 <primary sortas="b-config.rpath">config.rpath</primary>
109 </indexterm>
110 </listitem>
111 </varlistentry>
112
113 <varlistentry id="envsubst">
114 <term><command>envsubst</command></term>
115 <listitem>
116 <para>Substitutes environment variables in shell format strings</para>
117 <indexterm zone="ch-system-gettext envsubst">
118 <primary sortas="b-envsubst">envsubst</primary>
119 </indexterm>
120 </listitem>
121 </varlistentry>
122
123 <varlistentry id="gettext">
124 <term><command>gettext</command></term>
125 <listitem>
126 <para>Translates a natural language message into the user's language
127 by looking up the translation in a message catalog</para>
128 <indexterm zone="ch-system-gettext gettext">
129 <primary sortas="b-gettext">gettext</primary>
130 </indexterm>
131 </listitem>
132 </varlistentry>
133
134 <varlistentry id="gettextize">
135 <term><command>gettextize</command></term>
136 <listitem>
137 <para>Copies all standard Gettext files into the given top-level
138 directory of a package to begin internationalizing it</para>
139 <indexterm zone="ch-system-gettext gettextize">
140 <primary sortas="b-gettextize">gettextize</primary>
141 </indexterm>
142 </listitem>
143 </varlistentry>
144
145 <varlistentry id="hostname-gettext">
146 <term><command>hostname</command></term>
147 <listitem>
148 <para>Displays a network hostname in various forms</para>
149 <indexterm zone="ch-system-gettext hostname-gettext">
150 <primary sortas="b-hostname-gettext">hostname</primary>
151 </indexterm>
152 </listitem>
153 </varlistentry>
154
155 <varlistentry id="msgattrib">
156 <term><command>msgattrib</command></term>
157 <listitem>
158 <para>Filters the messages of a translation catalog according to their
159 attributes and manipulates the attributes</para>
160 <indexterm zone="ch-system-gettext msgattrib">
161 <primary sortas="b-msgattrib">msgattrib</primary>
162 </indexterm>
163 </listitem>
164 </varlistentry>
165
166 <varlistentry id="msgcat">
167 <term><command>msgcat</command></term>
168 <listitem>
169 <para>Concatenates and merges the given
170 <filename class="extension">.po</filename> files</para>
171 <indexterm zone="ch-system-gettext msgcat">
172 <primary sortas="b-msgcat">msgcat</primary>
173 </indexterm>
174 </listitem>
175 </varlistentry>
176
177 <varlistentry id="msgcmp">
178 <term><command>msgcmp</command></term>
179 <listitem>
180 <para>Compares two <filename class="extension">.po</filename>
181 files to check that both contain the same set of msgid strings</para>
182 <indexterm zone="ch-system-gettext msgcmp">
183 <primary sortas="b-msgcmp">msgcmp</primary>
184 </indexterm>
185 </listitem>
186 </varlistentry>
187
188 <varlistentry id="msgcomm">
189 <term><command>msgcomm</command></term>
190 <listitem>
191 <para>Finds the messages that are common to to the given
192 <filename class="extension">.po</filename> files</para>
193 <indexterm zone="ch-system-gettext msgcomm">
194 <primary sortas="b-msgcomm">msgcomm</primary>
195 </indexterm>
196 </listitem>
197 </varlistentry>
198
199 <varlistentry id="msgconv">
200 <term><command>msgconv</command></term>
201 <listitem>
202 <para>Converts a translation catalog to a different character
203 encoding</para>
204 <indexterm zone="ch-system-gettext msgconv">
205 <primary sortas="b-msgconv">msgconv</primary>
206 </indexterm>
207 </listitem>
208 </varlistentry>
209
210 <varlistentry id="msgen">
211 <term><command>msgen</command></term>
212 <listitem>
213 <para>Creates an English translation catalog</para>
214 <indexterm zone="ch-system-gettext msgen">
215 <primary sortas="b-msgen">msgen</primary>
216 </indexterm>
217 </listitem>
218 </varlistentry>
219
220 <varlistentry id="msgexec">
221 <term><command>msgexec</command></term>
222 <listitem>
223 <para>Applies a command to all translations of a translation
224 catalog</para>
225 <indexterm zone="ch-system-gettext msgexec">
226 <primary sortas="b-msgexec">msgexec</primary>
227 </indexterm>
228 </listitem>
229 </varlistentry>
230
231 <varlistentry id="msgfilter">
232 <term><command>msgfilter</command></term>
233 <listitem>
234 <para>Applies a filter to all translations of a translation
235 catalog</para>
236 <indexterm zone="ch-system-gettext msgfilter">
237 <primary sortas="b-msgfilter">msgfilter</primary>
238 </indexterm>
239 </listitem>
240 </varlistentry>
241
242 <varlistentry id="msgfmt">
243 <term><command>msgfmt</command></term>
244 <listitem>
245 <para>Generates a binary message catalog from a translation
246 catalog</para>
247 <indexterm zone="ch-system-gettext msgfmt">
248 <primary sortas="b-msgfmt">msgfmt</primary>
249 </indexterm>
250 </listitem>
251 </varlistentry>
252
253 <varlistentry id="msggrep">
254 <term><command>msggrep</command></term>
255 <listitem>
256 <para>Extracts all messages of a translation catalog that match a
257 given pattern or belong to some given source files</para>
258 <indexterm zone="ch-system-gettext msggrep">
259 <primary sortas="b-msggrep">msggrep</primary>
260 </indexterm>
261 </listitem>
262 </varlistentry>
263
264 <varlistentry id="msginit">
265 <term><command>msginit</command></term>
266 <listitem>
267 <para>Creates a new <filename class="extension">.po</filename> file,
268 initializing the meta information with values from the user's
269 environment</para>
270 <indexterm zone="ch-system-gettext msginit">
271 <primary sortas="b-msginit">msginit</primary>
272 </indexterm>
273 </listitem>
274 </varlistentry>
275
276 <varlistentry id="msgmerge">
277 <term><command>msgmerge</command></term>
278 <listitem>
279 <para>Combines two raw translations into a single file</para>
280 <indexterm zone="ch-system-gettext msgmerge">
281 <primary sortas="b-msgmerge">msgmerge</primary>
282 </indexterm>
283 </listitem>
284 </varlistentry>
285
286 <varlistentry id="msgunfmt">
287 <term><command>msgunfmt</command></term>
288 <listitem>
289 <para>Decompiles a binary message catalog into raw translation
290 text</para>
291 <indexterm zone="ch-system-gettext msgunfmt">
292 <primary sortas="b-msgunfmt">msgunfmt</primary>
293 </indexterm>
294 </listitem>
295 </varlistentry>
296
297 <varlistentry id="msguniq">
298 <term><command>msguniq</command></term>
299 <listitem>
300 <para>Unifies duplicate translations in a translation catalog</para>
301 <indexterm zone="ch-system-gettext msguniq">
302 <primary sortas="b-msguniq">msguniq</primary>
303 </indexterm>
304 </listitem>
305 </varlistentry>
306
307 <varlistentry id="ngettext">
308 <term><command>ngettext</command></term>
309 <listitem>
310 <para>Displays native language translations of a textual message whose
311 grammatical form depends on a number</para>
312 <indexterm zone="ch-system-gettext ngettext">
313 <primary sortas="b-ngettext">ngettext</primary>
314 </indexterm>
315 </listitem>
316 </varlistentry>
317
318 <varlistentry id="xgettext">
319 <term><command>xgettext</command></term>
320 <listitem>
321 <para>Extracts the translatable message lines from the given source
322 files to make the first translation template</para>
323 <indexterm zone="ch-system-gettext xgettext">
324 <primary sortas="b-xgettext">xgettext</primary>
325 </indexterm>
326 </listitem>
327 </varlistentry>
328
329 <varlistentry id="libasprintf">
330 <term><filename class="libraryfile">libasprintf</filename></term>
331 <listitem>
332 <para>defines the <emphasis>autosprintf</emphasis> class, which makes
333 C formatted output routines usable in C++ programs, for use with the
334 <emphasis>&lt;string&gt;</emphasis> strings and the
335 <emphasis>&lt;iostream&gt;</emphasis> streams</para>
336 <indexterm zone="ch-system-gettext libasprintf">
337 <primary sortas="c-libasprintf">libasprintf</primary>
338 </indexterm>
339 </listitem>
340 </varlistentry>
341
342 <varlistentry id="libgettextlib">
343 <term><filename class="libraryfile">libgettextlib</filename></term>
344 <listitem>
345 <para>a private library containing common routines used by the
346 various Gettext programs; these are not intended for general use</para>
347 <indexterm zone="ch-system-gettext libgettextlib">
348 <primary sortas="c-libgettextlib">libgettextlib</primary>
349 </indexterm>
350 </listitem>
351 </varlistentry>
352
353 <varlistentry id="libgettextpo">
354 <term><filename class="libraryfile">libgettextpo</filename></term>
355 <listitem>
356 <para>Used to write specialized programs that process
357 <filename class="extension">.po</filename> files; this library is
358 used when the standard applications shipped with Gettext (such as
359 <command>msgcomm</command>, <command>msgcmp</command>,
360 <command>msgattrib</command>, and <command>msgen</command>) will
361 not suffice</para>
362 <indexterm zone="ch-system-gettext libgettextpo">
363 <primary sortas="c-libgettextpo">libgettextpo</primary>
364 </indexterm>
365 </listitem>
366 </varlistentry>
367
368 <varlistentry id="libgettextsrc">
369 <term><filename class="libraryfile">libgettextsrc</filename></term>
370 <listitem>
371 <para>A private library containing common routines used by the
372 various Gettext programs; these are not intended for general use</para>
373 <indexterm zone="ch-system-gettext libgettextsrc">
374 <primary sortas="c-libgettextsrc">libgettextsrc</primary>
375 </indexterm>
376 </listitem>
377 </varlistentry>
378
379 </variablelist>
380
381 </sect2>
382
383</sect1>
Note: See TracBrowser for help on using the repository browser.