Changeset 81fd230 for chapter06/gettext.xml
- Timestamp:
- 02/19/2005 10:16:42 PM (19 years ago)
- Branches:
- 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, 6.1, 6.1.1, 6.3, 6.4, 6.5, 6.6, 6.7, 6.8, 7.0, 7.1, 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
- Children:
- 3d31fc4
- Parents:
- 2f9131f
- File:
-
- 1 edited
Legend:
- Unmodified
- Added
- Removed
-
chapter06/gettext.xml
r2f9131f r81fd230 4 4 %general-entities; 5 5 ]> 6 <sect1 id="ch-system-gettext" xreflabel="Gettext"role="wrap">6 <sect1 id="ch-system-gettext" role="wrap"> 7 7 <title>Gettext-&gettext-version;</title> 8 8 <?dbhtml filename="gettext.html"?> … … 11 11 12 12 <sect2 role="package"><title/> 13 <para>The Gettext package contains utilities for internationalization and 14 localization. These allow programs to be compiled with NLS, enabling them 15 to output messages in the user's native language.</para> 13 16 14 17 <segmentedlist> … … 18 21 </segmentedlist> 19 22 23 <segmentedlist> 24 <segtitle>Gettext installation depends on</segtitle> 25 <seglistitem><seg>Bash, Binutils, Bison, Coreutils, 26 Diffutils, Gawk, GCC, Glibc, Grep, Make, and Sed</seg></seglistitem> 27 </segmentedlist> 20 28 </sect2> 21 29 … … 32 40 33 41 <para>To test the results, issue: 34 <userinput>make check</userinput>.</para> 35 36 <para>Now install the package:</para> 42 <userinput>make check</userinput>. This takes a very long time, around 43 7 SBUs.</para> 44 45 <para>Install the package:</para> 37 46 38 47 <screen><userinput>make install</userinput></screen> … … 43 52 <sect2 id="contents-gettext" role="content"><title>Contents of Gettext</title> 44 53 45 <para>See testing</para> 54 <segmentedlist> 55 <segtitle>Installed programs</segtitle> 56 <segtitle>Installed libraries</segtitle> 57 <seglistitem><seg>autopoint, config.charset, config.rpath, envsubst, gettext, 58 gettextize, hostname, msgattrib, msgcat, msgcmp, msgcomm, msgconv, msgen, 59 msgexec, msgfilter, msgfmt, msggrep, msginit, msgmerge, msgunfmt, msguniq, 60 ngettext, and xgettext</seg> 61 <seg>libasprintf[a,so], libgettextlib[a,so], libgettextpo[a,so] and libgettextsrc[a,so]</seg></seglistitem> 62 </segmentedlist> 63 64 <variablelist><bridgehead renderas="sect3">Short Descriptions</bridgehead> 65 <?dbfo list-presentation="list"?> 66 67 <varlistentry id="autopoint"> 68 <term><command>autopoint</command></term> 69 <listitem> 70 <para>Copies standard Gettext infrastructure files into a source package</para> 71 <indexterm zone="ch-system-gettext autopoint"><primary sortas="b-autopoint">autopoint</primary></indexterm> 72 </listitem> 73 </varlistentry> 74 75 <varlistentry id="config.charset"> 76 <term><command>config.charset</command></term> 77 <listitem> 78 <para>Outputs a system-dependent table of character encoding aliases</para> 79 <indexterm zone="ch-system-gettext config.charset"><primary sortas="b-config.charset">config.charset</primary></indexterm> 80 </listitem> 81 </varlistentry> 82 83 <varlistentry id="config.rpath"> 84 <term><command>config.rpath</command></term> 85 <listitem> 86 <para>Outputs a system-dependent set of variables, describing how to set the 87 runtime search path of shared libraries in an executable</para> 88 <indexterm zone="ch-system-gettext config.rpath"><primary sortas="b-config.rpath">config.rpath</primary></indexterm> 89 </listitem> 90 </varlistentry> 91 92 <varlistentry id="envsubst"> 93 <term><command>envsubst</command></term> 94 <listitem> 95 <para>Substitutes environment variables in shell format strings</para> 96 <indexterm zone="ch-system-gettext envsubst"><primary sortas="b-envsubst">envsubst</primary></indexterm> 97 </listitem> 98 </varlistentry> 99 100 <varlistentry id="gettext"> 101 <term><command>gettext</command></term> 102 <listitem> 103 <para>Translates a natural language message into the user's language 104 by looking up the translation in a message catalog</para> 105 <indexterm zone="ch-system-gettext gettext"><primary sortas="b-gettext">gettext</primary></indexterm> 106 </listitem> 107 </varlistentry> 108 109 <varlistentry id="gettextize"> 110 <term><command>gettextize</command></term> 111 <listitem> 112 <para>Copies all standard Gettext files into the given top-level 113 directory of a package to begin internationalizing it</para> 114 <indexterm zone="ch-system-gettext gettextize"><primary sortas="b-gettextize">gettextize</primary></indexterm> 115 </listitem> 116 </varlistentry> 117 118 <varlistentry id="hostname-gettext"> 119 <term><command>hostname</command></term> 120 <listitem> 121 <para>Displays a network hostname in various forms</para> 122 <indexterm zone="ch-system-gettext hostname-gettext"><primary sortas="b-hostname-gettext">hostname</primary></indexterm> 123 </listitem> 124 </varlistentry> 125 126 <varlistentry id="msgattrib"> 127 <term><command>msgattrib</command></term> 128 <listitem> 129 <para>Filters the messages of a translation catalog according to their 130 attributes and manipulates the attributes</para> 131 <indexterm zone="ch-system-gettext msgattrib"><primary sortas="b-msgattrib">msgattrib</primary></indexterm> 132 </listitem> 133 </varlistentry> 134 135 <varlistentry id="msgcat"> 136 <term><command>msgcat</command></term> 137 <listitem> 138 <para>Concatenates and merges the given <filename class="extension">.po</filename> files</para> 139 <indexterm zone="ch-system-gettext msgcat"><primary sortas="b-msgcat">msgcat</primary></indexterm> 140 </listitem> 141 </varlistentry> 142 143 <varlistentry id="msgcmp"> 144 <term><command>msgcmp</command></term> 145 <listitem> 146 <para>Compares two <filename class="extension">.po</filename> 147 files to check that both contain the same set of msgid strings</para> 148 <indexterm zone="ch-system-gettext msgcmp"><primary sortas="b-msgcmp">msgcmp</primary></indexterm> 149 </listitem> 150 </varlistentry> 151 152 <varlistentry id="msgcomm"> 153 <term><command>msgcomm</command></term> 154 <listitem> 155 <para>Finds the messages that are common to 156 to the given <filename class="extension">.po</filename> files</para> 157 <indexterm zone="ch-system-gettext msgcomm"><primary sortas="b-msgcomm">msgcomm</primary></indexterm> 158 </listitem> 159 </varlistentry> 160 161 <varlistentry id="msgconv"> 162 <term><command>msgconv</command></term> 163 <listitem> 164 <para>Converts a translation catalog to a different character encoding</para> 165 <indexterm zone="ch-system-gettext msgconv"><primary sortas="b-msgconv">msgconv</primary></indexterm> 166 </listitem> 167 </varlistentry> 168 169 <varlistentry id="msgen"> 170 <term><command>msgen</command></term> 171 <listitem> 172 <para>Creates an English translation catalog</para> 173 <indexterm zone="ch-system-gettext msgen"><primary sortas="b-msgen">msgen</primary></indexterm> 174 </listitem> 175 </varlistentry> 176 177 <varlistentry id="msgexec"> 178 <term><command>msgexec</command></term> 179 <listitem> 180 <para>Applies a command to all translations of a translation catalog</para> 181 <indexterm zone="ch-system-gettext msgexec"><primary sortas="b-msgexec">msgexec</primary></indexterm> 182 </listitem> 183 </varlistentry> 184 185 <varlistentry id="msgfilter"> 186 <term><command>msgfilter</command></term> 187 <listitem> 188 <para>Applies a filter to all translations of a translation catalog</para> 189 <indexterm zone="ch-system-gettext msgfilter"><primary sortas="b-msgfilter">msgfilter</primary></indexterm> 190 </listitem> 191 </varlistentry> 192 193 <varlistentry id="msgfmt"> 194 <term><command>msgfmt</command></term> 195 <listitem> 196 <para>Generates a binary message catalog from from a translation catalog</para> 197 <indexterm zone="ch-system-gettext msgfmt"><primary sortas="b-msgfmt">msgfmt</primary></indexterm> 198 </listitem> 199 </varlistentry> 200 201 <varlistentry id="msggrep"> 202 <term><command>msggrep</command></term> 203 <listitem> 204 <para>Extracts all messages of a translation catalog that match a 205 given pattern or belong to some given source files</para> 206 <indexterm zone="ch-system-gettext msggrep"><primary sortas="b-msggrep">msggrep</primary></indexterm> 207 </listitem> 208 </varlistentry> 209 210 <varlistentry id="msginit"> 211 <term><command>msginit</command></term> 212 <listitem> 213 <para>Creates a new <filename class="extension">.po</filename> file, initializing the meta 214 information with values from the user's environment</para> 215 <indexterm zone="ch-system-gettext msginit"><primary sortas="b-msginit">msginit</primary></indexterm> 216 </listitem> 217 </varlistentry> 218 219 <varlistentry id="msgmerge"> 220 <term><command>msgmerge</command></term> 221 <listitem> 222 <para>Combines two raw translations into a single file</para> 223 <indexterm zone="ch-system-gettext msgmerge"><primary sortas="b-msgmerge">msgmerge</primary></indexterm> 224 </listitem> 225 </varlistentry> 226 227 <varlistentry id="msgunfmt"> 228 <term><command>msgunfmt</command></term> 229 <listitem> 230 <para>Decompiles a binary message catalog into raw translation text</para> 231 <indexterm zone="ch-system-gettext msgunfmt"><primary sortas="b-msgunfmt">msgunfmt</primary></indexterm> 232 </listitem> 233 </varlistentry> 234 235 <varlistentry id="msguniq"> 236 <term><command>msguniq</command></term> 237 <listitem> 238 <para>Unifies duplicate translations in a translation catalog</para> 239 <indexterm zone="ch-system-gettext msguniq"><primary sortas="b-msguniq">msguniq</primary></indexterm> 240 </listitem> 241 </varlistentry> 242 243 <varlistentry id="ngettext"> 244 <term><command>ngettext</command></term> 245 <listitem> 246 <para>Displays native language translations of a textual message whose 247 grammatical form depends on a number</para> 248 <indexterm zone="ch-system-gettext ngettext"><primary sortas="b-ngettext">ngettext</primary></indexterm> 249 </listitem> 250 </varlistentry> 251 252 <varlistentry id="xgettext"> 253 <term><command>xgettext</command></term> 254 <listitem> 255 <para>Extracts the translatable message lines from the given source 256 files to make the first translation template</para> 257 <indexterm zone="ch-system-gettext xgettext"><primary sortas="b-xgettext">xgettext</primary></indexterm> 258 </listitem> 259 </varlistentry> 260 261 <varlistentry id="libasprintf"> 262 <term><filename class="libraryfile">libasprintf</filename></term> 263 <listitem> 264 <para>defines the <emphasis>autosprintf</emphasis> class, which makes 265 C formatted output routines usable in C++ programs, for use with the 266 <emphasis><string></emphasis> strings and the 267 <emphasis><iostream></emphasis> streams</para> 268 <indexterm zone="ch-system-gettext libasprintf"><primary sortas="c-libasprintf">libasprintf</primary></indexterm> 269 </listitem> 270 </varlistentry> 271 272 <varlistentry id="libgettextlib"> 273 <term><filename class="libraryfile">libgettextlib</filename></term> 274 <listitem> 275 <para>a private library containing common routines used by the various Gettext 276 programs; these are not intended for general use</para> 277 <indexterm zone="ch-system-gettext libgettextlib"><primary sortas="c-libgettextlib">libgettextlib</primary></indexterm> 278 </listitem> 279 </varlistentry> 280 281 <varlistentry id="libgettextpo"> 282 <term><filename class="libraryfile">libgettextpo</filename></term> 283 <listitem> 284 <para>Used to write specialized programs that process <filename 285 class="extension">.po</filename> files; this library is used when the 286 standard applications shipped with Gettext (such as 287 <command>msgcomm</command>, <command>msgcmp</command>, 288 <command>msgattrib</command>, and <command>msgen</command>) will not 289 suffice</para> 290 <indexterm zone="ch-system-gettext libgettextpo"><primary sortas="c-libgettextpo">libgettextpo</primary></indexterm> 291 </listitem> 292 </varlistentry> 293 294 <varlistentry id="libgettextsrc"> 295 <term><filename class="libraryfile">libgettextsrc</filename></term> 296 <listitem> 297 <para>A private library containing common routines used by the various Gettext 298 programs; these are not intended for general use</para> 299 <indexterm zone="ch-system-gettext libgettextsrc"><primary sortas="c-libgettextsrc">libgettextsrc</primary></indexterm> 300 </listitem> 301 </varlistentry> 302 </variablelist> 46 303 47 304 </sect2> 48 305 49 306 </sect1> 307
Note:
See TracChangeset
for help on using the changeset viewer.