source: x/lib/pango.xml@ b9747b2

11.0 11.1 11.2 lazarus plabs/python-mods qt5new trunk upgradedb xry111/intltool xry111/soup3 xry111/test-20220226
Last change on this file since b9747b2 was b9747b2, checked in by Thomas Trepl (Moody) <thomas@…>, 16 months ago

Upgrade tp pango-1.48.9

  • Property mode set to 100644
File size: 8.8 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.48/pango-&pango-version;.tar.xz">
8 <!ENTITY pango-download-ftp "&gnome-download-ftp;/pango/1.48/pango-&pango-version;.tar.xz">
9 <!ENTITY pango-md5sum "243f05e6b2de17e5129402307e323e14">
10 <!ENTITY pango-size "1.9 MB">
11 <!ENTITY pango-buildsize "43 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 <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 &lfs110_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 <ulink url="https://ftpmirror.gnu.org/gnu/help2man">help2man</ulink>, and
100 <ulink url="https://linux.thai.net/projects/libthai">libthai</ulink>
101 </para>
102
103 <para condition="html" role="usernotes">
104 User Notes: <ulink url="&blfs-wiki;/pango"/>
105 </para>
106 </sect2>
107
108 <sect2 role="installation">
109 <title>Installation of Pango</title>
110
111 <para>
112 Install <application>Pango</application> by running the following
113 commands:
114 </para>
115
116<screen><userinput>mkdir build &amp;&amp;
117cd build &amp;&amp;
118
119meson --prefix=/usr --buildtype=release .. &amp;&amp;
120ninja</userinput></screen>
121
122 <para>
123 To test the results, issue: <command>ninja test</command>. One test,
124 <filename>test-font</filename>,
125 <!--<filename>test-layout</filename>, and
126 <filename>test-itemize</filename>, are known to fail if
127 <xref linkend="cantarell-fonts"/> are not installed.-->
128 is known to fail.
129 <!-- the 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 <para>
155 <option>-Dgtk_doc</option>: Use this switch if gtk-doc is
156 installed and you wish to rebuild and install the API documentation.
157 </para>
158
159 <para>
160 <option>-Dintrospection=false</option>: Use this switch if you do not
161 want to use <xref linkend="gobject-introspection"/>.
162 </para>
163
164 <!-- gi-docgen is now included in the tarball with 1.48.4
165 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
166 href="../../xincludes/meson-wrap-nodownload.xml"/>
167 -->
168 </sect2>
169
170 <sect2 role="configuration">
171 <title>Configuring Pango</title>
172
173 <sect3 id="pango-config">
174 <title>Config Files</title>
175
176 <para>
177 <filename>/etc/pango/pangorc</filename>, <filename>~/.pangorc</filename>
178 and the file specified in the environment variable
179 <envar>PANGO_RC_FILE</envar>
180 </para>
181
182 <indexterm zone="pango pango-config">
183 <primary sortas="e-etc-pango-pangorc">/etc/pango/pangorc</primary>
184 </indexterm>
185
186 <indexterm zone="pango pango-config">
187 <primary sortas="e-AA.pangorc">~/.pangorc</primary>
188 </indexterm>
189 </sect3>
190<!--
191 <sect3>
192 <title>Configuration Information</title>
193
194 <para>
195 The <application>Pango</application> module path is specified by the key
196 <userinput><parameter>Pango/ModulesPath</parameter></userinput> in the
197 <application>Pango</application> config database, which is read from the
198 config files listed above.
199 </para>
200
201 </sect3>-->
202
203 </sect2>
204
205 <sect2 role="content">
206 <title>Contents</title>
207
208 <segmentedlist>
209 <segtitle>Installed Programs</segtitle>
210 <segtitle>Installed Libraries</segtitle>
211 <segtitle>Installed Directories</segtitle>
212
213 <seglistitem>
214 <seg>
215 pango-list, pango-segmentation, and pango-view
216 </seg>
217 <seg>
218 libpango-1.0.so, libpangocairo-1.0.so, libpangoft2-1.0.so,
219 and libpangoxft-1.0.so
220 </seg>
221 <seg>
222 /usr/include/pango-1.0 and
223 /usr/share/gtk-doc/html/pango
224 </seg>
225 </seglistitem>
226 </segmentedlist>
227
228 <variablelist>
229 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
230 <?dbfo list-presentation="list"?>
231 <?dbhtml list-presentation="table"?>
232
233 <varlistentry id="pango-list">
234 <term><command>pango-list</command></term>
235 <listitem>
236 <para>
237 displays a list of fonts that <application>Pango</application>
238 can use that are currently installed on the system
239 </para>
240 <indexterm zone="pango pango-list">
241 <primary sortas="b-pango-list">pango-list</primary>
242 </indexterm>
243 </listitem>
244 </varlistentry>
245
246 <varlistentry id="pango-segmentation">
247 <term><command>pango-segmentation</command></term>
248 <listitem>
249 <para>
250 shows text segmentation as determined by Pango.
251 </para>
252 <indexterm zone="pango pango-segmentation">
253 <primary sortas="b-pango-segmentation">pango-segmentation</primary>
254 </indexterm>
255 </listitem>
256 </varlistentry>
257
258 <varlistentry id="pango-view">
259 <term><command>pango-view</command></term>
260 <listitem>
261 <para>
262 renders a given text file through <application>Pango</application>
263 for viewing purposes
264 </para>
265 <indexterm zone="pango pango-view">
266 <primary sortas="b-pango-view">pango-view</primary>
267 </indexterm>
268 </listitem>
269 </varlistentry>
270
271 <varlistentry id="libpango-1">
272 <term><filename class="libraryfile">libpango-1.0.so</filename></term>
273 <listitem>
274 <para>
275 contains low level layout rendering routines, a high level driver for
276 laying out entire blocks of text, and routines to assist in editing
277 internationalized text
278 </para>
279 <indexterm zone="pango libpango-1">
280 <primary sortas="c-libpango-1">libpango-1.0.so</primary>
281 </indexterm>
282 </listitem>
283 </varlistentry>
284
285 </variablelist>
286
287 </sect2>
288
289</sect1>
Note: See TracBrowser for help on using the repository browser.