source: chapter06/gettext.xml@ f1c177f

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 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 f1c177f was f1c177f, checked in by Matthew Burgess <matthew@…>, 12 years ago

Upgrade to Glibc-2.16.0. Fixes #3131.

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

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