source: chapter06/gettext.xml@ a07a34d

multilib-10.1
Last change on this file since a07a34d was a07a34d, checked in by Thomas Trepl <thomas@…>, 4 years ago

MultiLib: Merge changes from trunk

git-svn-id: http://svn.linuxfromscratch.org/LFS/branches/multilib@11821 4aa44e1e-78dd-0310-a6d2-fbcd4c07a689

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