source: chapter06/gettext.xml@ d5099ea

10.0 10.0-rc1 10.1 10.1-rc1 11.0 11.0-rc1 11.0-rc2 11.0-rc3 11.1 11.1-rc1 11.2 11.2-rc1 11.3 11.3-rc1 12.0 12.0-rc1 12.1 12.1-rc1 6.7 6.8 7.0 7.1 7.2 7.3 7.4 7.5 7.5-systemd 7.6 7.6-systemd 7.7 7.7-systemd 7.8 7.8-systemd 7.9 7.9-systemd 8.0 8.1 8.2 8.3 8.4 9.0 9.1 arm bdubbs/gcc13 ml-11.0 multilib renodr/libudev-from-systemd s6-init trunk xry111/arm64 xry111/arm64-12.0 xry111/clfs-ng xry111/lfs-next xry111/loongarch xry111/loongarch-12.0 xry111/loongarch-12.1 xry111/mips64el xry111/pip3 xry111/rust-wip-20221008 xry111/update-glibc
Last change on this file since d5099ea was d5099ea, checked in by Matthew Burgess <matthew@…>, 14 years ago

Upgrade to Gettext-0.18.1.1. Fixes #2686.

git-svn-id: http://svn.linuxfromscratch.org/LFS/trunk/BOOK@9307 4aa44e1e-78dd-0310-a6d2-fbcd4c07a689

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