glfs/x/lib/pango.xml
Krejzi 307b4b98bf Even more package updates.
git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@10902 af4574ff-66df-0310-9fd7-8a98e5e911e0
2012-12-30 15:34:51 +00:00

322 lines
9.2 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.32/pango-&pango-version;.tar.xz">
<!ENTITY pango-download-ftp "&gnome-download-ftp;/pango/1.32/pango-&pango-version;.tar.xz">
<!ENTITY pango-md5sum "8e846804d6e219bc795a26a4a39b5bfd">
<!ENTITY pango-size "976 KB">
<!ENTITY pango-buildsize "26 MB">
<!ENTITY pango-time "0.2 SBU">
<!ENTITY pangox-download-http "&gnome-download-http;/pangox-compat/0.0/pangox-compat-&pangox-version;.tar.xz">
<!ENTITY pangox-download-ftp "&gnome-download-ftp;/pangox-compat/0.0/pangox-compat-&pangox-version;.tar.xz">
<!ENTITY pangox-md5sum "7bcbd0187f03e1e27af9a81e07249c33">
<!ENTITY pangox-size "264 KB">
<!ENTITY pangox-buildsize "3.2 MB">
<!ENTITY pangox-time "less than 0.1 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
<application>Pango</application> so far has been done in the context of
the <application>GTK+</application> widget toolkit.
</para>
&lfs72_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">Additional Downloads</bridgehead>
<itemizedlist spacing="compact">
<listitem>
<para>
Download (HTTP): <ulink url="&pangox-download-http;"/>
</para>
</listitem>
<listitem>
<para>
Download (FTP): <ulink url="&pangox-download-ftp;"/>
</para>
</listitem>
<listitem>
<para>
Download MD5 sum: &pangox-md5sum;
</para>
</listitem>
<listitem>
<para>
Download size: &pangox-size;
</para>
</listitem>
<listitem>
<para>
Estimated disk space required: &pangox-buildsize;
</para>
</listitem>
<listitem>
<para>
Estimated build time: &pangox-time;
</para>
</listitem>
</itemizedlist>
<bridgehead renderas="sect3">Pango Dependencies</bridgehead>
<bridgehead renderas="sect4">Required</bridgehead>
<para role="required">
<xref linkend="cairo"/>,
<xref linkend="harfbuzz"/> and
<xref linkend="xorg7-lib"/>
</para>
<bridgehead renderas="sect4">Optional (Required if building GNOME)</bridgehead>
<para role="optional">
<xref linkend="gobject-introspection"/>
</para>
<bridgehead renderas="sect4">Optional</bridgehead>
<para role="optional">
<xref linkend="gtk-doc"/>
</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>.
</para>
<para>
Now, as the <systemitem class="username">root</systemitem> user:
</para>
<screen role="root"><userinput>make install</userinput></screen>
<note>
<para>
If you installed the package on to your system using a
<quote>DESTDIR</quote> method, an important file was not installed and
must be copied and/or generated. Generate it using the following
command as the <systemitem class="username">root</systemitem> user:
</para>
<screen role="root"><userinput>pango-querymodules --update-cache</userinput></screen>
</note>
</sect2>
<sect2 role="installation">
<title>Installation of Pangox Compat</title>
<para>
Install <application>Pangox Compat</application> by running the following
commands:
</para>
<screen><userinput>./configure --prefix=/usr \
--sysconfdir=/etc \
--disable-static &amp;&amp;
make</userinput></screen>
<para>
This package does not come with a testsuite.
</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/static-libraries.xml"/>
<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 and 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="libpango-1">
<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 libpango-1">
<primary sortas="c-libpango-1">libpango-1.0.so</primary>
</indexterm>
</listitem>
</varlistentry>
</variablelist>
</sect2>
</sect1>