source: BOOK/final-system/common/gettext.xml@ 1756a6e

clfs-1.2 clfs-2.1 clfs-3.0.0-systemd clfs-3.0.0-sysvinit systemd sysvinit
Last change on this file since 1756a6e was 1323820, checked in by Chris Staub <chris@…>, 16 years ago

Missed a couple references to new library in previous commit

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