source: chapter06/gettext.xml@ 7e131ea

10.0 10.0-rc1 10.1 10.1-rc1 11.0 11.0-rc1 11.0-rc2 11.0-rc3 8.0 8.0-rc1 8.1 8.1-rc1 8.1-rc2 8.2 8.2-rc1 8.3 8.3-rc1 8.3-rc2 8.4 8.4-rc1 9.0 9.0-rc1 9.1 9.1-rc1 cross-chap5 ml-11.0 multilib old-trunk trunk xry111/git-transition xry111/glibc-2.34 xry111/tester-nohack xry111/usr-move
Last change on this file since 7e131ea was 7e131ea, checked in by Bruce Dubbs <bdubbs@…>, 5 years ago

Update to glibc-2.25.
Revert gperf to version 3.0.4.
Update to linux-4.9.8.tar.xz.
Update to check-0.11.0.
Update to shadow-4.4.
Update to e2fsprogs-1.43.4.
Update to sed-4.4.

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

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