source: x/lib/pango.xml@ 1f8aae36

11.1 11.2 lazarus trunk xry111/intltool xry111/soup3 xry111/test-20220226
Last change on this file since 1f8aae36 was 1f8aae36, checked in by Bruce Dubbs <bdubbs@…>, 10 months ago

Update to pango-1.50.2.

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