source: gnome/add/gal.xml@ 1c579035

<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
   "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
  <!ENTITY % general-entities SYSTEM "../../general.ent">
  %general-entities;

<!ENTITY gal-download-http "http://ftp.gnome.org/pub/gnome/sources/gal/2.4/gal-&gal-version;.tar.bz2">
<!ENTITY gal-download-ftp "ftp://ftp.gnome.org/pub/gnome/sources/gal/2.4/gal-&gal-version;.tar.bz2">
<!ENTITY gal-md5sum "70e07fde659f0553ba56caeae4f51908">
<!ENTITY gal-size "1.2 MB">
<!ENTITY gal-buildsize "63 MB">
<!ENTITY gal-time "1.5 SBU">
]>

<sect1 id="gal" xreflabel="GAL-&gal-version;">
<sect1info>
<othername>$LastChangedBy$</othername>
<date>$Date$</date>
</sect1info>
<?dbhtml filename="gal.html"?>
<title>GAL-&gal-version;</title>

<sect2>
<title>Introduction to <application>GAL</application></title>

<para>The <application>GAL</application> package contains library
functions that came from <application>Evolution</application> and
<application>Gnumeric</application>.
<application><acronym>GAL</acronym></application> is short for
<application><acronym>GNOME</acronym></application> Application Libs.</para>

<sect3><title>Package information</title>
<itemizedlist spacing='compact'>
<listitem><para>Download (HTTP): 
<ulink url="&gal-download-http;"/></para></listitem>
<listitem><para>Download (FTP): 
<ulink url="&gal-download-ftp;"/></para></listitem>
<listitem><para>Download MD5 sum: &gal-md5sum;</para></listitem>
<listitem><para>Download size: &gal-size;</para></listitem>
<listitem><para>Estimated disk space required: 
&gal-buildsize;</para></listitem>
<listitem><para>Estimated build time: 
&gal-time;</para></listitem></itemizedlist>
</sect3>

<sect3><title><application>GAL</application> dependencies</title>
<sect4><title>Required</title>
<para><xref linkend="libgnomeui"/> and 
<xref linkend="libgnomeprintui"/></para>
</sect4>

<sect4><title>Optional</title>
<para><xref linkend="gtk-doc"/></para>
</sect4>
</sect3>

</sect2>

<sect2>
<title>Installation of <application>GAL</application></title>

<para>In order to build the documentation using 
<application>GTK-Doc</application>, issue the following commands to fix a 
build problem:</para>

<screen><userinput><command>mv docs/gal-decl.txt docs/gal-2.4-decl.txt &amp;&amp;
mv docs/gal-sections.txt docs/gal-2.4-sections.txt &amp;&amp;
sed -i -e "s/gal-decl/gal-2.4-decl/" \
       -e "s/gal-sections/gal-2.4-sections/" docs/Makefile.in</command></userinput></screen>

<para>Install <application>GAL</application> by running the following 
commands:</para>

<screen><userinput><command>./configure --prefix=`pkg-config --variable=prefix ORBit-2.0` &amp;&amp;
make</command></userinput></screen>

<para>This package does not come with a test suite.</para>

<para>Now, as the root user:</para>

<screen><userinput role='root'><command>make install</command></userinput></screen>

</sect2>

<sect2>
<title>Contents</title>

<para>The <application>GAL</application> package contains library routines 
pulled from the <application>Evolution</application> and 
<application>Gnumeric</application> projects and repackaged as a generic 
library.</para>

</sect2>

</sect1>