glfs/x/lib/pango.xml
Krejzi fcf1326ddc pango 1.30.0
git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@9817 af4574ff-66df-0310-9fd7-8a98e5e911e0
2012-03-30 20:33:39 +00:00

218 lines
6.9 KiB
XML

<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../../general.ent">
%general-entities;
<!ENTITY pango-download-http "&gnome-download-http;/pango/1.30/pango-&pango-version;.tar.xz">
<!ENTITY pango-download-ftp "&gnome-download-ftp;/pango/1.30/pango-&pango-version;.tar.xz">
<!ENTITY pango-md5sum "2a70627ffd9f43c52c04cc0b05fe359f">
<!ENTITY pango-size "1.1 MB">
<!ENTITY pango-buildsize "36 MB">
<!ENTITY pango-time "0.4 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><application>Pango</application> is a library for laying out
and rendering of text, with an emphasis on internationalization.
It can be used anywhere that text layout is needed, though most
of the work on Pango so far has been done in the context of the GTK+
widget toolkit.</para>
&lfs71_checked;
<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>
<!-- I don't see any use of pango except for GTK+, so make
cairo, fontconfig, and xorg libraries dependency. -->
<bridgehead renderas="sect4">Required</bridgehead>
<para role="required"><xref linkend="cairo"/>,
<xref linkend="fontconfig"/>, <xref linkend="pkgconfig"/>
and <xref linkend="xorg7-lib"/></para>
<bridgehead renderas="sect4">Recommended</bridgehead>
<para role="recommended"><xref linkend="gobject-introspection"/>
(Required if building GNOME)</para>
<bridgehead renderas="sect4">Optional</bridgehead>
<para role="optional"><xref linkend="gtk-doc"/> and
<ulink url="http://linux.thai.net/libthai">LibThai</ulink>
</para>
<para condition="html" role="usernotes">User Notes:
<ulink url="&blfs-wiki;/pango"/></para>
</sect2>
<sect2 role="installation">
<title>Installation of Pango</title>
<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>. You can
install <xref linkend="gtk-doc"/> if you wish to test the documentation
section of the test suite. Also, the <quote>testboundries</quote> test
could fail if you have <application>LibThai</application> installed.
</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>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../../xincludes/gtk-doc-rebuild.xml"/>
</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 Programs</segtitle>
<segtitle>Installed Libraries</segtitle>
<segtitle>Installed Directories</segtitle>
<seglistitem>
<seg>
pango-querymodules and pango-view
</seg>
<seg>
libpango-1.0.so, libpangocairo-1.0.so, libpangoft2-1.0.so,
libpangox-1.0.so, libpangoxft-1.0.so
</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-view">
<term><command>pango-view</command></term>
<listitem>
<para>renders a given file through <application>Pango</application>
for viewing purposes.</para>
<indexterm zone="pango pango-view">
<primary sortas="b-pango-view">pango-view</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="Pango-libraries">
<term><filename class="libraryfile">libpango*-1.0.so</filename></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">libpango*-1.0.so</primary>
</indexterm>
</listitem>
</varlistentry>
</variablelist>
</sect2>
</sect1>