source: x/lib/pango.xml@ a8e1b4ab

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 a8e1b4ab was a8e1b4ab, checked in by Ken Moffat <ken@…>, 16 months ago

gdk-pixbuf, pango:

Add --wrap-mode=no-fallback to prevent gi-docgen getting downloaded
if you have the (python3) deps present. Comment gtk-doc in these
packages, explain that gi-docgen is used for the documentation.

  • Property mode set to 100644
File size: 8.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.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 (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>. One test,
125 <filename>test-font</filename>,
126 <!--<filename>test-layout</filename>, and
127 <filename>test-itemize</filename>, are known to fail if
128 <xref linkend="cantarell-fonts"/> are not installed.-->
129 is known to fail.
130 <!-- the problematic tests get skipped now -->
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=false</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
226 </seg>
227 </seglistitem>
228 </segmentedlist>
229
230 <variablelist>
231 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
232 <?dbfo list-presentation="list"?>
233 <?dbhtml list-presentation="table"?>
234
235 <varlistentry id="pango-list">
236 <term><command>pango-list</command></term>
237 <listitem>
238 <para>
239 displays a list of fonts that <application>Pango</application>
240 can use that are currently installed on the system
241 </para>
242 <indexterm zone="pango pango-list">
243 <primary sortas="b-pango-list">pango-list</primary>
244 </indexterm>
245 </listitem>
246 </varlistentry>
247
248 <varlistentry id="pango-segmentation">
249 <term><command>pango-segmentation</command></term>
250 <listitem>
251 <para>
252 shows text segmentation as determined by Pango.
253 </para>
254 <indexterm zone="pango pango-segmentation">
255 <primary sortas="b-pango-segmentation">pango-segmentation</primary>
256 </indexterm>
257 </listitem>
258 </varlistentry>
259
260 <varlistentry id="pango-view">
261 <term><command>pango-view</command></term>
262 <listitem>
263 <para>
264 renders a given text file through <application>Pango</application>
265 for viewing purposes
266 </para>
267 <indexterm zone="pango pango-view">
268 <primary sortas="b-pango-view">pango-view</primary>
269 </indexterm>
270 </listitem>
271 </varlistentry>
272
273 <varlistentry id="libpango-1">
274 <term><filename class="libraryfile">libpango-1.0.so</filename></term>
275 <listitem>
276 <para>
277 contains low level layout rendering routines, a high level driver for
278 laying out entire blocks of text, and routines to assist in editing
279 internationalized text
280 </para>
281 <indexterm zone="pango libpango-1">
282 <primary sortas="c-libpango-1">libpango-1.0.so</primary>
283 </indexterm>
284 </listitem>
285 </varlistentry>
286
287 </variablelist>
288
289 </sect2>
290
291</sect1>
Note: See TracBrowser for help on using the repository browser.