source: x/lib/pango.xml@ b338131

11.0 ken/refactor-virt lazarus qt5new trunk xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since b338131 was b338131, checked in by Bruce Dubbs <bdubbs@…>, 7 months ago

Grammar

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

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