source: x/lib/pango.xml@ 6746ab1

10.1 11.0 ken/refactor-virt lazarus qt5new trunk upgradedb xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since 6746ab1 was 6746ab1, checked in by Douglas R. Reno <renodr@…>, 13 months ago

Update to xfconf-4.14.4
Update to pango-1.48.0
Update to fontforge-20201107
Update to seahorse-3.38.0.1
Update to mesa-20.2.2
libspiro: remove extraneous Dependencies section

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@23889 af4574ff-66df-0310-9fd7-8a98e5e911e0

  • Property mode set to 100644
File size: 7.9 KB
Line 
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
3 "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
4 <!ENTITY % general-entities SYSTEM "../../general.ent">
5 %general-entities;
6
7 <!ENTITY pango-download-http "&gnome-download-http;/pango/1.46/pango-&pango-version;.tar.xz">
8 <!ENTITY pango-download-ftp "&gnome-download-ftp;/pango/1.46/pango-&pango-version;.tar.xz">
9 <!ENTITY pango-md5sum "ee5826242abd661fb5238e19b9e2e1aa">
10 <!ENTITY pango-size "524 KB">
11 <!ENTITY pango-buildsize "26 MB (with tests)">
12 <!ENTITY pango-time "0.2 SBU (with tests)">
13]>
14
15<sect1 id="pango" xreflabel="Pango-&pango-version;">
16 <?dbhtml filename="pango.html" ?>
17
18 <sect1info>
19 <othername>$LastChangedBy$</othername>
20 <date>$Date$</date>
21 </sect1info>
22
23 <title>Pango-&pango-version;</title>
24
25 <indexterm zone="pango">
26 <primary sortas="a-Pango">Pango</primary>
27 </indexterm>
28
29 <sect2 role="package">
30 <title>Introduction to Pango</title>
31
32 <para>
33 <application>Pango</application> is a library for laying out and rendering
34 text, with an emphasis on internationalization. It can be used anywhere
35 that text layout is needed, though most of the work on
36 <application>Pango</application> so far has been done in the context of
37 the <application>GTK+</application> widget toolkit.
38 </para>
39
40 &lfs10_checked;
41
42 <bridgehead renderas="sect3">Package Information</bridgehead>
43 <itemizedlist spacing="compact">
44 <listitem>
45 <para>
46 Download (HTTP): <ulink url="&pango-download-http;"/>
47 </para>
48 </listitem>
49 <listitem>
50 <para>
51 Download (FTP): <ulink url="&pango-download-ftp;"/>
52 </para>
53 </listitem>
54 <listitem>
55 <para>
56 Download MD5 sum: &pango-md5sum;
57 </para>
58 </listitem>
59 <listitem>
60 <para>
61 Download size: &pango-size;
62 </para>
63 </listitem>
64 <listitem>
65 <para>
66 Estimated disk space required: &pango-buildsize;
67 </para>
68 </listitem>
69 <listitem>
70 <para>
71 Estimated build time: &pango-time;
72 </para>
73 </listitem>
74 </itemizedlist>
75
76 <bridgehead renderas="sect3">Pango Dependencies</bridgehead>
77
78 <bridgehead renderas="sect4">Required</bridgehead>
79 <para role="required">
80 <xref linkend="fontconfig"/> (must be built with
81 <xref linkend="freetype2"/> using <xref linkend="harfbuzz"/>),
82 <xref linkend="fribidi"/>, and
83 <xref linkend="glib2"/>
84
85 </para>
86
87 <bridgehead renderas="sect4">Recommended</bridgehead>
88 <para role="recommended">
89 <xref linkend="cairo"/>,
90 <xref linkend="gobject-introspection"/> (Required if building GNOME), and
91 <xref linkend="xorg7-lib"/>
92 </para>
93
94 <bridgehead renderas="sect4">Optional</bridgehead>
95 <para role="optional">
96 <xref linkend="cantarell-fonts"/> (for tests),
97 <xref linkend="gtk-doc"/>,
98 <ulink url="https://ftpmirror.gnu.org/gnu/help2man">help2man</ulink>, and
99 <ulink url="https://linux.thai.net/projects/libthai">libthai</ulink>
100 </para>
101
102 <para condition="html" role="usernotes">
103 User Notes: <ulink url="&blfs-wiki;/pango"/>
104 </para>
105 </sect2>
106
107 <sect2 role="installation">
108 <title>Installation of Pango</title>
109
110 <para>
111 Install <application>Pango</application> by running the following
112 commands:
113 </para>
114
115<screen><userinput>mkdir build &amp;&amp;
116cd build &amp;&amp;
117
118meson --prefix=/usr --sysconfdir=/etc .. &amp;&amp;
119ninja</userinput></screen>
120
121 <para>
122 To test the results, issue: <command>ninja test</command>. Two tests,
123 <filename>test-layout</filename> and
124 <filename>test-itemize</filename>, are known to fail if
125 <xref linkend="cantarell-fonts"/> is not installed.
126 </para>
127
128 <para>
129 Now, as the <systemitem class="username">root</systemitem> user:
130 </para>
131
132<screen role="root"><userinput>ninja install</userinput></screen>
133
134<!--
135This requires the external help2man program to generate pango-view.1. The version
136from lsb_release is insufficient. I'm not sure if the command below is needed
137or not if the newer help2man is present. - Bruce
138
139install -vm 644 ../utils/pango-view.1.in /usr/share/man/man1/pango-view.1</userinput></screen>
140-->
141
142 </sect2>
143
144 <sect2 role="commands">
145 <title>Command Explanations</title>
146
147 <para>
148 <option>-Denable-docs</option>: Use this switch if gtk-doc is
149 installed and you wish to rebuild and install the API documentation.
150 </para>
151
152 <para>
153 <option>-Dgir=false</option>: Use this switch if you do not want to
154 use <xref linkend="gobject-introspection"/>.
155 </para>
156
157 </sect2>
158
159 <sect2 role="configuration">
160 <title>Configuring Pango</title>
161
162 <sect3 id="pango-config">
163 <title>Config Files</title>
164
165 <para>
166 <filename>/etc/pango/pangorc</filename>, <filename>~/.pangorc</filename>
167 and the file specified in the environment variable
168 <envar>PANGO_RC_FILE</envar>
169 </para>
170
171 <indexterm zone="pango pango-config">
172 <primary sortas="e-etc-pango-pangorc">/etc/pango/pangorc</primary>
173 </indexterm>
174
175 <indexterm zone="pango pango-config">
176 <primary sortas="e-AA.pangorc">~/.pangorc</primary>
177 </indexterm>
178 </sect3>
179<!--
180 <sect3>
181 <title>Configuration Information</title>
182
183 <para>
184 The <application>Pango</application> module path is specified by the key
185 <userinput><parameter>Pango/ModulesPath</parameter></userinput> in the
186 <application>Pango</application> config database, which is read from the
187 config files listed above.
188 </para>
189
190 </sect3>-->
191
192 </sect2>
193
194 <sect2 role="content">
195 <title>Contents</title>
196
197 <segmentedlist>
198 <segtitle>Installed Programs</segtitle>
199 <segtitle>Installed Libraries</segtitle>
200 <segtitle>Installed Directories</segtitle>
201
202 <seglistitem>
203 <seg>
204 pango-list and pango-view
205 </seg>
206 <seg>
207 libpango-1.0.so, libpangocairo-1.0.so, libpangoft2-1.0.so,
208 and libpangoxft-1.0.so
209 </seg>
210 <seg>
211 /usr/include/pango-1.0 and
212 /usr/share/gtk-doc/html/pango
213 </seg>
214 </seglistitem>
215 </segmentedlist>
216
217 <variablelist>
218 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
219 <?dbfo list-presentation="list"?>
220 <?dbhtml list-presentation="table"?>
221
222 <varlistentry id="pango-list">
223 <term><command>pango-list</command></term>
224 <listitem>
225 <para>
226 displays a list of fonts that <application>Pango</application>
227 can use that are currently installed on the system.
228 </para>
229 <indexterm zone="pango pango-list">
230 <primary sortas="b-pango-list">pango-list</primary>
231 </indexterm>
232 </listitem>
233 </varlistentry>
234
235 <varlistentry id="pango-view">
236 <term><command>pango-view</command></term>
237 <listitem>
238 <para>
239 renders a given text file through <application>Pango</application>
240 for viewing purposes.
241 </para>
242 <indexterm zone="pango pango-view">
243 <primary sortas="b-pango-view">pango-view</primary>
244 </indexterm>
245 </listitem>
246 </varlistentry>
247
248 <varlistentry id="libpango-1">
249 <term><filename class="libraryfile">libpango-1.0.so</filename></term>
250 <listitem>
251 <para>
252 contains low level layout rendering routines, a high level driver for
253 laying out entire blocks of text, and routines to assist in editing
254 internationalized text.
255 </para>
256 <indexterm zone="pango libpango-1">
257 <primary sortas="c-libpango-1">libpango-1.0.so</primary>
258 </indexterm>
259 </listitem>
260 </varlistentry>
261
262 </variablelist>
263
264 </sect2>
265
266</sect1>
Note: See TracBrowser for help on using the repository browser.