source: x/lib/pango.xml@ 14d1bd9

10.0 10.1 11.0 ken/refactor-virt lazarus qt5new trunk xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since 14d1bd9 was 14d1bd9, checked in by Bruce Dubbs <bdubbs@…>, 15 months ago

Update to gtk+3.24.22.
Update to emacs-27.1.
Update to pango-1.46.0.
Update to vala-0.48.9.

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@23498 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.44/pango-&pango-version;.tar.xz">
8 <!ENTITY pango-download-ftp "&gnome-download-ftp;/pango/1.44/pango-&pango-version;.tar.xz">
9 <!ENTITY pango-md5sum "6fc4e718c846350f81a8b1ac51a502ff">
10 <!ENTITY pango-size "520 KB">
11 <!ENTITY pango-buildsize "19 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 &lfs91_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://ftp.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>. Three tests,
123 <filename>test-layout</filename>,
124 <filename>test-break</filename>, and
125 <filename>test-itemize</filename> are known to fail if
126 <xref linkend="cantarell-fonts"/> is not installed.
127 </para>
128
129 <para>
130 Now, as the <systemitem class="username">root</systemitem> user:
131 </para>
132
133<screen role="root"><userinput>ninja install</userinput></screen>
134
135<!--
136This requires the external help2man program to generate pango-view.1. The version
137from lsb_release is insufficient. I'm not sure if the command below is needed
138or not if the newer help2man is present. - Bruce
139
140install -vm 644 ../utils/pango-view.1.in /usr/share/man/man1/pango-view.1</userinput></screen>
141-->
142
143 </sect2>
144
145 <sect2 role="commands">
146 <title>Command Explanations</title>
147
148 <para>
149 <option>-Denable-docs</option>: Use this switch if gtk-doc is
150 installed and you wish to rebuild and install the API documentation.
151 </para>
152
153 <para>
154 <option>-Dgir=false</option>: Use this switch if you do not want to
155 use <xref linkend="gobject-introspection"/>.
156 </para>
157
158 </sect2>
159
160 <sect2 role="configuration">
161 <title>Configuring Pango</title>
162
163 <sect3 id="pango-config">
164 <title>Config Files</title>
165
166 <para>
167 <filename>/etc/pango/pangorc</filename>, <filename>~/.pangorc</filename>
168 and the file specified in the environment variable
169 <envar>PANGO_RC_FILE</envar>
170 </para>
171
172 <indexterm zone="pango pango-config">
173 <primary sortas="e-etc-pango-pangorc">/etc/pango/pangorc</primary>
174 </indexterm>
175
176 <indexterm zone="pango pango-config">
177 <primary sortas="e-AA.pangorc">~/.pangorc</primary>
178 </indexterm>
179 </sect3>
180<!--
181 <sect3>
182 <title>Configuration Information</title>
183
184 <para>
185 The <application>Pango</application> module path is specified by the key
186 <userinput><parameter>Pango/ModulesPath</parameter></userinput> in the
187 <application>Pango</application> config database, which is read from the
188 config files listed above.
189 </para>
190
191 </sect3>-->
192
193 </sect2>
194
195 <sect2 role="content">
196 <title>Contents</title>
197
198 <segmentedlist>
199 <segtitle>Installed Programs</segtitle>
200 <segtitle>Installed Libraries</segtitle>
201 <segtitle>Installed Directories</segtitle>
202
203 <seglistitem>
204 <seg>
205 pango-list and pango-view
206 </seg>
207 <seg>
208 libpango-1.0.so, libpangocairo-1.0.so, libpangoft2-1.0.so,
209 and libpangoxft-1.0.so
210 </seg>
211 <seg>
212 /usr/include/pango-1.0 and
213 /usr/share/gtk-doc/html/pango
214 </seg>
215 </seglistitem>
216 </segmentedlist>
217
218 <variablelist>
219 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
220 <?dbfo list-presentation="list"?>
221 <?dbhtml list-presentation="table"?>
222
223 <varlistentry id="pango-list">
224 <term><command>pango-list</command></term>
225 <listitem>
226 <para>
227 displays a list of fonts that <application>Pango</application>
228 can use that are currently installed on the system.
229 </para>
230 <indexterm zone="pango pango-list">
231 <primary sortas="b-pango-list">pango-list</primary>
232 </indexterm>
233 </listitem>
234 </varlistentry>
235
236 <varlistentry id="pango-view">
237 <term><command>pango-view</command></term>
238 <listitem>
239 <para>
240 renders a given text file through <application>Pango</application>
241 for viewing purposes.
242 </para>
243 <indexterm zone="pango pango-view">
244 <primary sortas="b-pango-view">pango-view</primary>
245 </indexterm>
246 </listitem>
247 </varlistentry>
248
249 <varlistentry id="libpango-1">
250 <term><filename class="libraryfile">libpango-1.0.so</filename></term>
251 <listitem>
252 <para>
253 contains low level layout rendering routines, a high level driver for
254 laying out entire blocks of text, and routines to assist in editing
255 internationalized text.
256 </para>
257 <indexterm zone="pango libpango-1">
258 <primary sortas="c-libpango-1">libpango-1.0.so</primary>
259 </indexterm>
260 </listitem>
261 </varlistentry>
262
263 </variablelist>
264
265 </sect2>
266
267</sect1>
Note: See TracBrowser for help on using the repository browser.