chapter05/gettext.xml

   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-tools-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-tools-gettext">
  20     <primary sortas="a-Gettext">Gettext</primary>
  21     <secondary>tools</secondary>
  22   </indexterm>
  23
  24   <sect2 role="package">
  25     <title/>
  26
  27     <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
  28     href="../chapter06/gettext.xml"
  29     xpointer="xpointer(/sect1/sect2[1]/para[1])"/>
  30
  31     <segmentedlist>
  32       <segtitle>&buildtime;</segtitle>
  33       <segtitle>&diskspace;</segtitle>
  34
  35       <seglistitem>
  36         <seg>&gettext-ch5-sbu;</seg>
  37         <seg>&gettext-ch5-du;</seg>
  38       </seglistitem>
  39     </segmentedlist>
  40
  41   </sect2>
  42
  43   <sect2 role="installation">
  44     <title>Installation of Gettext</title>
  45
  46     <para>For our temporary set of tools, we only need to install
  47     three programs from Gettext.</para>
  48
  49     <para>Prepare Gettext for compilation:</para>
  50
  51 <screen><userinput remap="configure">./configure --disable-shared</userinput></screen>
  52
  53     <variablelist>
  54       <title>The meaning of the configure option:</title>
  55 <!--
  56       <varlistentry>
  57         <term><parameter>EMACS="no"</parameter></term>
  58         <listitem>
  59           <para>This prevents the configure script from determining where to
  60           install Emacs Lisp files as the test is known to hang on some hosts.
  61           </para>
  62         </listitem>
  63       </varlistentry>
  64 -->
  65       <varlistentry>
  66         <term><parameter>--disable-shared</parameter></term>
  67         <listitem>
  68           <para>We do not need to install any of the shared Gettext libraries at
  69           this time, therefore there is no need to build them.</para>
  70         </listitem>
  71       </varlistentry>
  72
  73     </variablelist>
  74
  75     <para>Compile the package:</para>
  76
  77 <screen><userinput remap="make">make</userinput></screen>
  78
  79     <para>
  80     Due to the limited environment, running the test suite at this stage
  81     is not recommended.</para>
  82
  83     <para>Install the <command>msgfmt</command>, <command>msgmerge</command> and
  84     <command>xgettext</command> programs:</para>
  85
  86 <screen><userinput remap="install">cp -v gettext-tools/src/{msgfmt,msgmerge,xgettext} /tools/bin</userinput></screen>
  87
  88   </sect2>
  89
  90   <sect2 role="content">
  91     <title/>
  92
  93     <para>Details on this package are located in
  94     <xref linkend="contents-gettext" role="."/></para>
  95
  96   </sect2>
  97
  98 </sect1>