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 build and install
  47     three programs from Gettext.</para>
  48
  49     <para>Prepare Gettext for compilation:</para>
  50
  51 <screen><userinput remap="configure">cd gettext-tools
  52 EMACS="no" ./configure --prefix=/tools --disable-shared</userinput></screen>
  53
  54     <variablelist>
  55       <title>The meaning of the configure option:</title>
  56
  57       <varlistentry>
  58         <term><parameter>EMACS="no"</parameter></term>
  59         <listitem>
  60           <para>This prevents the configure script from determining where to
  61           install Emacs Lisp files as the test is known to hang on some hosts.
  62           </para>
  63         </listitem>
  64       </varlistentry>
  65
  66       <varlistentry>
  67         <term><parameter>--disable-shared</parameter></term>
  68         <listitem>
  69           <para>We do not need to install any of the shared Gettext libraries at
  70           this time, therefore there is no need to build them.</para>
  71         </listitem>
  72       </varlistentry>
  73
  74     </variablelist>
  75
  76     <para>Compile the package:</para>
  77
  78 <screen><userinput remap="make">make -C gnulib-lib
  79 make -C src msgfmt
  80 make -C src msgmerge
  81 make -C src xgettext</userinput></screen>
  82
  83     <para>As only three programs have been compiled, it is not possible to run the
  84     test suite without compiling additional support libraries from the Gettext
  85     package. It is therefore not recommended to attempt to run the test suite at
  86     this stage.</para>
  87
  88     <para>Install the <command>msgfmt</command>, <command>msgmerge</command> and
  89     <command>xgettext</command> programs:</para>
  90
  91 <screen><userinput remap="install">cp -v src/{msgfmt,msgmerge,xgettext} /tools/bin</userinput></screen>
  92
  93   </sect2>
  94
  95   <sect2 role="content">
  96     <title/>
  97
  98     <para>Details on this package are located in
  99     <xref linkend="contents-gettext" role="."/></para>
 100
 101   </sect2>
 102
 103 </sect1>