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

clfs-1.2clfs-2.1clfs-3.0.0-systemdclfs-3.0.0-sysvinitsystemdsysvinit
Last change on this file since e29fb58 was e29fb58, checked in by Jim Gifford <clfs@…>, 15 years ago

r3912@server (orig r1760): chris | 2006-06-09 23:52:26 -0700
Updated lists of installed programs for several packages

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