Changeset 3f0c882 for chapter06/gettext.xml
- Timestamp:
- 12/21/2004 07:38:32 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:
- 3d36131c
- Parents:
- aaa3260
- File:
-
- 1 edited
Legend:
- Unmodified
- Added
- Removed
-
chapter06/gettext.xml
raaa3260 r3f0c882 11 11 12 12 <sect2 role="package"><title/> 13 <para>The Gettext package contains utilities for internationalization and14 localization. These allow programs to be compiled with Native Language Support15 (NLS), enabling them to output messages in the user's native language.</para>16 13 17 14 <segmentedlist> … … 21 18 </segmentedlist> 22 19 23 <segmentedlist>24 <segtitle>Gettext installation depends on</segtitle>25 <seglistitem><seg>Bash, Binutils, Bison, Coreutils,26 Diffutils, Gawk, GCC, Glibc, Grep, Make, Sed</seg></seglistitem>27 </segmentedlist>28 20 </sect2> 29 21 … … 40 32 41 33 <para>To test the results, issue: 42 <userinput>make check</userinput>. This takes a very long time, around 43 7 SBUs.</para> 34 <userinput>make check</userinput>.</para> 44 35 45 36 <para>Now install the package:</para> … … 52 43 <sect2 id="contents-gettext" role="content"><title>Contents of Gettext</title> 53 44 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, project-id, team-address, trigger, urlget, user-email 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><title>Short descriptions</title> 65 66 <varlistentry id="autopoint"> 67 <term><command>autopoint</command></term> 68 <listitem> 69 <indexterm zone="ch-system-gettext autopoint"><primary sortas="b-autopoint">autopoint</primary></indexterm> 70 <para>copies standard Gettext infrastructure files into a source package.</para> 71 </listitem> 72 </varlistentry> 73 74 <varlistentry id="config.charset"> 75 <term><command>config.charset</command></term> 76 <listitem> 77 <indexterm zone="ch-system-gettext config.charset"><primary sortas="b-config.charset">config.charset</primary></indexterm> 78 <para>outputs a system-dependent table of character encoding aliases.</para> 79 </listitem> 80 </varlistentry> 81 82 <varlistentry id="config.rpath"> 83 <term><command>config.rpath</command></term> 84 <listitem> 85 <indexterm zone="ch-system-gettext config.rpath"><primary sortas="b-config.rpath">config.rpath</primary></indexterm> 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 </listitem> 89 </varlistentry> 90 91 <varlistentry id="envsubst"> 92 <term><command>envsubst</command></term> 93 <listitem> 94 <indexterm zone="ch-system-gettext envsubst"><primary sortas="b-envsubst">envsubst</primary></indexterm> 95 <para>substitutes environment variables in shell format strings.</para> 96 </listitem> 97 </varlistentry> 98 99 <varlistentry id="gettext"> 100 <term><command>gettext</command></term> 101 <listitem> 102 <indexterm zone="ch-system-gettext gettext"><primary sortas="b-gettext">gettext</primary></indexterm> 103 <para>translates a natural language message into 104 the user's language, by looking up the translation in a message catalog.</para> 105 </listitem> 106 </varlistentry> 107 108 <varlistentry id="gettextize"> 109 <term><command>gettextize</command></term> 110 <listitem> 111 <indexterm zone="ch-system-gettext gettextize"><primary sortas="b-gettextize">gettextize</primary></indexterm> 112 <para>copies all standard Gettext files into 113 the given top-level directory of a package, to begin inter-nationalizing it.</para> 114 </listitem> 115 </varlistentry> 116 117 <varlistentry id="hostname-gettext"> 118 <term><command>hostname</command></term> 119 <listitem> 120 <indexterm zone="ch-system-gettext hostname-gettext"><primary sortas="b-hostname-gettext">hostname</primary></indexterm> 121 <para>displays a network hostname in various forms.</para> 122 </listitem> 123 </varlistentry> 124 125 <varlistentry id="msgattrib"> 126 <term><command>msgattrib</command></term> 127 <listitem> 128 <indexterm zone="ch-system-gettext msgattrib"><primary sortas="b-msgattrib">msgattrib</primary></indexterm> 129 <para>filters the messages of a translation 130 catalog according to their attributes and manipulates the attributes.</para> 131 </listitem> 132 </varlistentry> 133 134 <varlistentry id="msgcat"> 135 <term><command>msgcat</command></term> 136 <listitem> 137 <indexterm zone="ch-system-gettext msgcat"><primary sortas="b-msgcat">msgcat</primary></indexterm> 138 <para>concatenates and merges the given <filename class="extension">.po</filename> files.</para> 139 </listitem> 140 </varlistentry> 141 142 <varlistentry id="msgcmp"> 143 <term><command>msgcmp</command></term> 144 <listitem> 145 <indexterm zone="ch-system-gettext msgcmp"><primary sortas="b-msgcmp">msgcmp</primary></indexterm> 146 <para>compares two <filename class="extension">.po</filename> 147 files to check that both contain the same set of msgid strings.</para> 148 </listitem> 149 </varlistentry> 150 151 <varlistentry id="msgcomm"> 152 <term><command>msgcomm</command></term> 153 <listitem> 154 <indexterm zone="ch-system-gettext msgcomm"><primary sortas="b-msgcomm">msgcomm</primary></indexterm> 155 <para>finds the messages that are common to 156 to the given <filename class="extension">.po</filename> files.</para> 157 </listitem> 158 </varlistentry> 159 160 <varlistentry id="msgconv"> 161 <term><command>msgconv</command></term> 162 <listitem> 163 <indexterm zone="ch-system-gettext msgconv"><primary sortas="b-msgconv">msgconv</primary></indexterm> 164 <para>converts a translation catalog to a different character encoding.</para> 165 </listitem> 166 </varlistentry> 167 168 <varlistentry id="msgen"> 169 <term><command>msgen</command></term> 170 <listitem> 171 <indexterm zone="ch-system-gettext msgen"><primary sortas="b-msgen">msgen</primary></indexterm> 172 <para>creates an English translation catalog.</para> 173 </listitem> 174 </varlistentry> 175 176 <varlistentry id="msgexec"> 177 <term><command>msgexec</command></term> 178 <listitem> 179 <indexterm zone="ch-system-gettext msgexec"><primary sortas="b-msgexec">msgexec</primary></indexterm> 180 <para>applies a command to all translations of a translation catalog.</para> 181 </listitem> 182 </varlistentry> 183 184 <varlistentry id="msgfilter"> 185 <term><command>msgfilter</command></term> 186 <listitem> 187 <indexterm zone="ch-system-gettext msgfilter"><primary sortas="b-msgfilter">msgfilter</primary></indexterm> 188 <para>applies a filter to all translations of a translation catalog.</para> 189 </listitem> 190 </varlistentry> 191 192 <varlistentry id="msgfmt"> 193 <term><command>msgfmt</command></term> 194 <listitem> 195 <indexterm zone="ch-system-gettext msgfmt"><primary sortas="b-msgfmt">msgfmt</primary></indexterm> 196 <para>generates a binary message catalog from from a translation catalog.</para> 197 </listitem> 198 </varlistentry> 199 200 <varlistentry id="msggrep"> 201 <term><command>msggrep</command></term> 202 <listitem> 203 <indexterm zone="ch-system-gettext msggrep"><primary sortas="b-msggrep">msggrep</primary></indexterm> 204 <para>extracts all messages of a translation 205 catalog that match a given pattern or belong to some given source files.</para> 206 </listitem> 207 </varlistentry> 208 209 <varlistentry id="msginit"> 210 <term><command>msginit</command></term> 211 <listitem> 212 <indexterm zone="ch-system-gettext msginit"><primary sortas="b-msginit">msginit</primary></indexterm> 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 </listitem> 216 </varlistentry> 217 218 <varlistentry id="msgmerge"> 219 <term><command>msgmerge</command></term> 220 <listitem> 221 <indexterm zone="ch-system-gettext msgmerge"><primary sortas="b-msgmerge">msgmerge</primary></indexterm> 222 <para>combines two raw translations into a single file.</para> 223 </listitem> 224 </varlistentry> 225 226 <varlistentry id="msgunfmt"> 227 <term><command>msgunfmt</command></term> 228 <listitem> 229 <indexterm zone="ch-system-gettext msgunfmt"><primary sortas="b-msgunfmt">msgunfmt</primary></indexterm> 230 <para>decompiles a binary message catalog into raw translation text.</para> 231 </listitem> 232 </varlistentry> 233 234 <varlistentry id="msguniq"> 235 <term><command>msguniq</command></term> 236 <listitem> 237 <indexterm zone="ch-system-gettext msguniq"><primary sortas="b-msguniq">msguniq</primary></indexterm> 238 <para>unifies duplicate translations in a translation catalog.</para> 239 </listitem> 240 </varlistentry> 241 242 <varlistentry id="ngettext"> 243 <term><command>ngettext</command></term> 244 <listitem> 245 <indexterm zone="ch-system-gettext ngettext"><primary sortas="b-ngettext">ngettext</primary></indexterm> 246 <para>displays native language translations of a 247 textual message whose grammatical form depends on a number.</para> 248 </listitem> 249 </varlistentry> 250 251 <varlistentry id="xgettext"> 252 <term><command>xgettext</command></term> 253 <listitem> 254 <indexterm zone="ch-system-gettext xgettext"><primary sortas="b-xgettext">xgettext</primary></indexterm> 255 <para>extracts the translatable message lines 256 from the given source files, to make the first translation template.</para> 257 </listitem> 258 </varlistentry> 259 260 <varlistentry id="libasprintf"> 261 <term><filename class="libraryfile">libasprintf</filename></term> 262 <listitem> 263 <indexterm zone="ch-system-gettext libasprintf"><primary sortas="c-libasprintf">libasprintf</primary></indexterm> 264 <para>defines the autosprintf class, which 265 makes C formatted output routines usable in C++ programs, for use with the 266 <string> strings and the <iostream> streams.</para> 267 </listitem> 268 </varlistentry> 269 270 <varlistentry id="libgettextlib"> 271 <term><filename class="libraryfile">libgettextlib</filename></term> 272 <listitem> 273 <indexterm zone="ch-system-gettext libgettextlib"><primary sortas="c-libgettextlib">libgettextlib</primary></indexterm> 274 <para>is a private library containing common routines used by the various Gettext 275 programs. They're not meant for general use.</para> 276 </listitem> 277 </varlistentry> 278 279 <varlistentry id="libgettextpo"> 280 <term><filename class="libraryfile">libgettextpo</filename></term> 281 <listitem> 282 <indexterm zone="ch-system-gettext libgettextpo"><primary sortas="c-libgettextpo">libgettextpo</primary></indexterm> 283 <para>is used to write specialized programs that process <filename 284 class="extension">.po</filename> files. This library is 285 used when the standard applications shipped with Gettext won't suffice (such as 286 <command>msgcomm</command>, <command>msgcmp</command>, 287 <command>msgattrib</command> and <command>msgen</command>).</para> 288 </listitem> 289 </varlistentry> 290 291 <varlistentry id="libgettextsrc"> 292 <term><filename class="libraryfile">libgettextsrc</filename></term> 293 <listitem> 294 <indexterm zone="ch-system-gettext libgettextsrc"><primary sortas="c-libgettextsrc">libgettextsrc</primary></indexterm> 295 <para>is a private library containing common routines used by the various Gettext 296 programs. They're not meant for general use.</para> 297 </listitem> 298 </varlistentry> 299 </variablelist> 45 <para>See testing</para> 300 46 301 47 </sect2>
Note:
See TracChangeset
for help on using the changeset viewer.