source: x/lib/pango.xml@ f521e912

10.0 10.1 11.0 11.1 11.2 9.1 lazarus plabs/python-mods qt5new trunk upgradedb xry111/intltool xry111/soup3 xry111/test-20220226
Last change on this file since f521e912 was f521e912, checked in by Douglas R. Reno <renodr@…>, 3 years ago

Typo fx

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@22303 af4574ff-66df-0310-9fd7-8a98e5e911e0

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