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 intl pluralx.c
  80 make -C src msgfmt
  81 make -C src msgmerge
  82 make -C src xgettext</userinput></screen>
  83
  84     <para>As only three programs have been compiled, it is not possible to run the
  85     test suite without compiling additional support libraries from the Gettext
  86     package. It is therefore not recommended to attempt to run the test suite at
  87     this stage.</para>
  88
  89     <para>Install the <command>msgfmt</command>, <command>msgmerge</command> and
  90     <command>xgettext</command> programs:</para>
  91
  92 <screen><userinput remap="install">cp -v src/{msgfmt,msgmerge,xgettext} /tools/bin</userinput></screen>
  93
  94   </sect2>
  95
  96   <sect2 role="content">
  97     <title/>
  98
  99     <para>Details on this package are located in
 100     <xref linkend="contents-gettext" role="."/></para>
 101
 102   </sect2>
 103
 104 </sect1>