source: x/lib/pango.xml@ 0eabe98

11.3 12.0 12.1 12.2 gimp3 kea ken/TL2024 ken/inkscape-core-mods ken/tuningfonts lazarus lxqt plabs/newcss plabs/python-mods python3.11 qt5new rahul/power-profiles-daemon renodr/vulkan-addition trunk xry111/for-12.3 xry111/llvm18 xry111/spidermonkey128 xry111/xf86-video-removal
Last change on this file since 0eabe98 was 0eabe98, checked in by Bruce Dubbs <bdubbs@…>, 2 years ago

Update to pango-1.50.11.

  • Property mode set to 100644
File size: 9.1 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 "3ff7ab8644a0622f96e7d7f547074096">
10 <!ENTITY pango-size "4.1 MB">
11 <!ENTITY pango-buildsize "47 MB (with tests)">
12 <!ENTITY pango-time "0.1 SBU (Using parallelism=4; 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 &lfs112_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 <!-- Even with cantarell-fonts, pango-1.50.9 test-font fails again. -->
131 </para>
132
133 <para>
134 Now, as the <systemitem class="username">root</systemitem> user:
135 </para>
136
137<screen role="root"><userinput>ninja install</userinput></screen>
138
139<!--
140This requires the external help2man program to generate pango-view.1. The version
141from lsb_release is insufficient. I'm not sure if the command below is needed
142or not if the newer help2man is present. - Bruce
143
144install -vm 644 ../utils/pango-view.1.in /usr/share/man/man1/pango-view.1</userinput></screen>
145-->
146
147 </sect2>
148
149 <sect2 role="commands">
150 <title>Command Explanations</title>
151
152 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
153 href="../../xincludes/meson-buildtype-release.xml"/>
154
155 <!-- gtk-doc replaced by gi-docgen
156 <para>
157 <option>-Dgtk_doc</option>: Use this switch if gtk-doc is
158 installed and you wish to rebuild and install the API documentation.
159 </para>-->
160
161 <para>
162 <option>-Dintrospection=disabled</option>: Use this switch if you do not
163 want to use <xref linkend="gobject-introspection"/>.
164 </para>
165
166 <!-- gi-docgen can get installed without this, if deps exist -->
167 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
168 href="../../xincludes/meson-wrap-nofallback.xml"/>
169
170 </sect2>
171
172 <sect2 role="configuration">
173 <title>Configuring Pango</title>
174
175 <sect3 id="pango-config">
176 <title>Config Files</title>
177
178 <para>
179 <filename>/etc/pango/pangorc</filename>, <filename>~/.pangorc</filename>
180 and the file specified in the environment variable
181 <envar>PANGO_RC_FILE</envar>
182 </para>
183
184 <indexterm zone="pango pango-config">
185 <primary sortas="e-etc-pango-pangorc">/etc/pango/pangorc</primary>
186 </indexterm>
187
188 <indexterm zone="pango pango-config">
189 <primary sortas="e-AA.pangorc">~/.pangorc</primary>
190 </indexterm>
191 </sect3>
192<!--
193 <sect3>
194 <title>Configuration Information</title>
195
196 <para>
197 The <application>Pango</application> module path is specified by the key
198 <userinput><parameter>Pango/ModulesPath</parameter></userinput> in the
199 <application>Pango</application> config database, which is read from the
200 config files listed above.
201 </para>
202
203 </sect3>-->
204
205 </sect2>
206
207 <sect2 role="content">
208 <title>Contents</title>
209
210 <segmentedlist>
211 <segtitle>Installed Programs</segtitle>
212 <segtitle>Installed Libraries</segtitle>
213 <segtitle>Installed Directories</segtitle>
214
215 <seglistitem>
216 <seg>
217 pango-list, pango-segmentation, and pango-view
218 </seg>
219 <seg>
220 libpango-1.0.so, libpangocairo-1.0.so, libpangoft2-1.0.so,
221 and libpangoxft-1.0.so
222 </seg>
223 <seg>
224 /usr/include/pango-1.0<!-- and
225 /usr/share/gtk-doc/html/pango
226this last one does not seem to be installed now (since pango-1.48.2 at least)
227-->
228 </seg>
229 </seglistitem>
230 </segmentedlist>
231
232 <variablelist>
233 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
234 <?dbfo list-presentation="list"?>
235 <?dbhtml list-presentation="table"?>
236
237 <varlistentry id="pango-list">
238 <term><command>pango-list</command></term>
239 <listitem>
240 <para>
241 displays a list of fonts that <application>Pango</application>
242 can use that are currently installed on the system
243 </para>
244 <indexterm zone="pango pango-list">
245 <primary sortas="b-pango-list">pango-list</primary>
246 </indexterm>
247 </listitem>
248 </varlistentry>
249
250 <varlistentry id="pango-segmentation">
251 <term><command>pango-segmentation</command></term>
252 <listitem>
253 <para>
254 shows text segmentation as determined by Pango.
255 </para>
256 <indexterm zone="pango pango-segmentation">
257 <primary sortas="b-pango-segmentation">pango-segmentation</primary>
258 </indexterm>
259 </listitem>
260 </varlistentry>
261
262 <varlistentry id="pango-view">
263 <term><command>pango-view</command></term>
264 <listitem>
265 <para>
266 renders a given text file through <application>Pango</application>
267 for viewing purposes
268 </para>
269 <indexterm zone="pango pango-view">
270 <primary sortas="b-pango-view">pango-view</primary>
271 </indexterm>
272 </listitem>
273 </varlistentry>
274
275 <varlistentry id="libpango-1">
276 <term><filename class="libraryfile">libpango-1.0.so</filename></term>
277 <listitem>
278 <para>
279 contains low level layout rendering routines, a high level driver for
280 laying out entire blocks of text, and routines to assist in editing
281 internationalized text
282 </para>
283 <indexterm zone="pango libpango-1">
284 <primary sortas="c-libpango-1">libpango-1.0.so</primary>
285 </indexterm>
286 </listitem>
287 </varlistentry>
288
289 </variablelist>
290
291 </sect2>
292
293</sect1>
Note: See TracBrowser for help on using the repository browser.