glfs/x/lib/pango.xml
Douglas R. Reno d278ced360 Update to gjs-1.45.4
Added several seds to packages to silence libtool warnings
Added wayland-protocols to trunk and modified GTK+3 instructions to reflect this
Typo fixes and text changes
Added systemd-specific CUPS restart info back to Gutenprint
Added a note in babl that generating the docs takes a long time.

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@17605 af4574ff-66df-0310-9fd7-8a98e5e911e0
2016-07-22 21:00:54 +00:00

250 lines
7.3 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.40/pango-&pango-version;.tar.xz">
<!ENTITY pango-download-ftp "&gnome-download-ftp;/pango/1.40/pango-&pango-version;.tar.xz">
<!ENTITY pango-md5sum "6fc88c6529890d6c8e03074d57a3eceb">
<!ENTITY pango-size "1 MB">
<!ENTITY pango-buildsize "21 MB (with tests)">
<!ENTITY pango-time "0.4 SBU (with tests)">
]>
<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>
&lfs79_checked;&gcc6_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>
<bridgehead renderas="sect4">Required</bridgehead>
<para role="required">
<xref linkend="fontconfig"/> (must be built with
<xref linkend="freetype2"/> using <xref linkend="harfbuzz"/>) and
<xref linkend="glib2"/>
</para>
<bridgehead renderas="sect4">Recommended</bridgehead>
<para role="recommended">
<xref linkend="cairo"/> 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"/> and
<ulink url="https://github.com/GNOME/cantarell-fonts/releases">Cantrell Fonts</ulink> (for tests)
</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>sed -i "/seems to be moved/s/^/#/" ltmain.sh &amp;&amp;
./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="commands">
<title>Command Explanations</title>
<para>
<command>sed -i ... ltmain.sh</command>: This sed silences several
useless and annoying warnings generated from libtool.
</para>
<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-view
</seg>
<seg>
libpango-1.0.so, libpangocairo-1.0.so, libpangoft2-1.0.so,
and libpangoxft-1.0.so
</seg>
<seg>
/usr/include/pango-1.0 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-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>
contains 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>