glfs/x/lib/pango.xml
Randy McMurchy 887c9496d9 Updated to Pango-1.10.0
git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@5100 af4574ff-66df-0310-9fd7-8a98e5e911e0
2005-09-20 23:30:25 +00:00

201 lines
6.8 KiB
XML

<?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 pango-download-http "http://ftp.gnome.org/pub/GNOME/sources/pango/1.10/pango-&pango-version;.tar.bz2">
<!ENTITY pango-download-ftp "ftp://ftp.gtk.org/pub/gtk/v2.8/pango-&pango-version;.tar.bz2">
<!ENTITY pango-md5sum "c75489ec7f5fe77e31e4cbde71ad0c16">
<!ENTITY pango-size "1.1 MB">
<!ENTITY pango-buildsize "23.1 MB">
<!ENTITY pango-time "0.5 SBU">
]>
<sect1 id="pango" xreflabel="Pango-&pango-version;">
<?dbhtml filename="pango.html" ?>
<sect1info>
<othername>$LastChangedBy$</othername>
<date>$Date$</date>
</sect1info>
<title>Pango-&pango-version;</title>
<indexterm zone="pango">
<primary sortas="a-Pango">Pango</primary>
</indexterm>
<sect2 role="package">
<title>Introduction to Pango</title>
<para>The <application>Pango</application> package contains the
<filename class="libraryfile">libpango</filename> libraries. These are
useful for the layout and rendering of text.</para>
<bridgehead renderas="sect3">Package Information</bridgehead>
<itemizedlist spacing="compact">
<listitem>
<para>Download (HTTP): <ulink url="&pango-download-http;"/></para>
</listitem>
<listitem>
<para>Download (FTP): <ulink url="&pango-download-ftp;"/></para>
</listitem>
<listitem>
<para>Download MD5 sum: &pango-md5sum;</para>
</listitem>
<listitem>
<para>Download size: &pango-size;</para>
</listitem>
<listitem>
<para>Estimated disk space required: &pango-buildsize;</para>
</listitem>
<listitem>
<para>Estimated build time: &pango-time;</para>
</listitem>
</itemizedlist>
<bridgehead renderas="sect3">Pango Dependencies</bridgehead>
<bridgehead renderas="sect4">Required</bridgehead>
<para><xref linkend="glib2"/></para>
<bridgehead renderas="sect4">Recommended</bridgehead>
<para><xref linkend="cairo"/></para>
<para><application>cairo</application> is not required to build
<application>Pango</application>, but if you don't build
<application>Pango</application> with a <application>cairo</application>
backend, then <application>GTK+</application>-2 will not build.</para>
<bridgehead renderas="sect4">Optional (If <application>cairo</application>
is Not Installed)</bridgehead>
<para>X (<xref linkend="xfree86"/> or <xref linkend="xorg"/>) and
<xref linkend="fontconfig"/></para>
<bridgehead renderas="sect4">Optional (To Rebuild the API Documentation)</bridgehead>
<para><xref linkend="gtk-doc"/></para>
</sect2>
<sect2 role="installation">
<title>Installation of Pango</title>
<para>In order for <application>Pango</application> to find
<application>Xft</application>, the <envar>PKG_CONFIG_PATH</envar> must
include <filename class="directory">/usr/X11R6/lib/pkgconfig</filename>.
This is a good time to add it if you haven't already. You can utilize
the example for <filename>X.sh</filename> to create a script for
modifying this variable located in the section
<xref linkend="postlfs-config-profile"/>.</para>
<para>Install <application>Pango</application> by running the following
commands:</para>
<screen><userinput>./configure --prefix=/usr --sysconfdir=/etc &amp;&amp;
make</userinput></screen>
<para>To test the results, issue: <command>make check</command>.</para>
<para>Now, as the <systemitem class="username">root</systemitem> user:</para>
<screen role="root"><userinput>make install</userinput></screen>
</sect2>
<sect2 role="commands">
<title>Command Explanations</title>
<para><parameter>--sysconfdir=/etc</parameter>: This switch installs the
configuration files into <filename class="directory">/etc</filename>
instead of <filename class="directory">/usr/etc</filename>.</para>
<para><option>--enable-gtk-doc</option>: This switch will rebuild
the API documentation during the <command>make</command> command.</para>
</sect2>
<sect2 role="configuration">
<title>Configuring Pango</title>
<sect3 id="pango-config">
<title>Config Files</title>
<para><filename>/etc/pango/pangorc</filename>,
<filename>~/.pangorc</filename>, and the file specified in the
environment variable <envar>PANGO_RC_FILE</envar></para>
<indexterm zone="pango pango-config">
<primary sortas="e-etc-pango-pangorc">/etc/pango/pangorc</primary>
</indexterm>
<indexterm zone="pango pango-config">
<primary sortas="e-AA.pangorc">~/.pangorc</primary>
</indexterm>
</sect3>
<sect3>
<title>Configuration Information</title>
<para>The <application>Pango</application> module path is specified by
the key <userinput><parameter>Pango/ModulesPath</parameter></userinput>
in the <application>Pango</application> config database, which is read
from the config files listed above.</para>
</sect3>
</sect2>
<sect2 role="content">
<title>Contents</title>
<segmentedlist>
<segtitle>Installed Program</segtitle>
<segtitle>Installed Libraries</segtitle>
<segtitle>Installed Directories</segtitle>
<seglistitem>
<seg>pango-querymodules</seg>
<seg>libpango*-1.0.so and <application>Pango</application> loadable
modules.</seg>
<seg>/etc/pango, /usr/include/pango-1.0, /usr/lib/pango, and
/usr/share/gtk-doc/html/pango</seg>
</seglistitem>
</segmentedlist>
<variablelist>
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
<?dbfo list-presentation="list"?>
<?dbhtml list-presentation="table"?>
<varlistentry id="pango-querymodules">
<term><command>pango-querymodules</command></term>
<listitem>
<para>is a module registration utility that collects
information about <application>Pango</application> loadable
modules.</para>
<indexterm zone="pango pango-querymodules">
<primary sortas="b-pango-querymodules">pango-querymodules</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="Pango-libraries">
<term>Pango libraries</term>
<listitem>
<para>contain low level layout rendering routines, a high
level driver for laying out entire blocks of text, and routines
to assist in editing internationalized text.</para>
<indexterm zone="pango Pango-libraries">
<primary sortas="c-Pango-libraries">Pango libraries</primary>
</indexterm>
</listitem>
</varlistentry>
</variablelist>
</sect2>
</sect1>