source: x/lib/gtk+2.xml@ c8e80d51

12.0 12.1 ken/TL2024 ken/tuningfonts lazarus plabs/newcss python3.11 rahul/power-profiles-daemon renodr/vulkan-addition trunk xry111/llvm18
Last change on this file since c8e80d51 was 30c1c72, checked in by Douglas R. Reno <renodr@…>, 10 months ago

Tag GTK+-2, GTK+-3, and Sawfish
  • Property mode set to 100644
File size: 11.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 gtk2-download-http "&gnome-download-http;/gtk+/2.24/gtk+-&gtk2-version;.tar.xz">
8 <!ENTITY gtk2-download-ftp "&gnome-download-ftp;/gtk+/2.24/gtk+-&gtk2-version;.tar.xz">
9 <!ENTITY gtk2-md5sum "0118e98dbe0e4dab90ce475f9f0e6c0c">
10 <!ENTITY gtk2-size "12 MB">
11 <!ENTITY gtk2-buildsize "285 MB">
12 <!ENTITY gtk2-time "0.9 SBU (using parallelism=4; add 0.1 SBU for tests)">
13]>
14
15<sect1 id="gtk2" xreflabel="GTK+-&gtk2-version;">
16 <?dbhtml filename="gtk2.html" ?>
17
18
19 <title>GTK+-&gtk2-version;</title>
20
21 <indexterm zone="gtk2">
22 <primary sortas="a-GTK+2">GTK+2</primary>
23 </indexterm>
24
25 <sect2 role="package">
26 <title>Introduction to GTK+ 2</title>
27
28 <para>
29 The <application>GTK+ 2</application> package contains
30 libraries used for creating graphical user interfaces
31 for applications.
32 </para>
33
34 &lfs120_checked;
35
36 <bridgehead renderas="sect3">Package Information</bridgehead>
37 <itemizedlist spacing="compact">
38 <listitem>
39 <para>
40 Download (HTTP): <ulink url="&gtk2-download-http;"/>
41 </para>
42 </listitem>
43 <listitem>
44 <para>
45 Download (FTP): <ulink url="&gtk2-download-ftp;"/>
46 </para>
47 </listitem>
48 <listitem>
49 <para>
50 Download MD5 sum: &gtk2-md5sum;
51 </para>
52 </listitem>
53 <listitem>
54 <para>
55 Download size: &gtk2-size;
56 </para>
57 </listitem>
58 <listitem>
59 <para>
60 Estimated disk space required: &gtk2-buildsize;
61 </para>
62 </listitem>
63 <listitem>
64 <para>
65 Estimated build time: &gtk2-time;
66 </para>
67 </listitem>
68 </itemizedlist>
69
70 <bridgehead renderas="sect3">GTK+ 2 Dependencies</bridgehead>
71
72 <bridgehead renderas="sect4">Required</bridgehead>
73 <para role="required">
74 <xref linkend="at-spi2-core"/>,
75 <xref linkend="gdk-pixbuf"/> and
76 <xref linkend="pango"/>
77 </para>
78
79 <bridgehead renderas="sect4">Recommended</bridgehead>
80 <para role="recommended">
81 <xref linkend="hicolor-icon-theme"/>
82 </para>
83
84 <bridgehead renderas="sect4">Optional</bridgehead>
85 <para role="optional">
86 <xref linkend="cups"/>,
87 <xref linkend="docbook-utils"/>,
88 <xref role="runtime" linkend="gnome-themes-extra"/> (runtime, for
89 Adwaita and HighContrast themes),
90 <xref linkend="gobject-introspection"/> and
91 <xref linkend="gtk-doc"/>
92 </para>
93
94 <note>
95 <para>
96 If <xref linkend="gobject-introspection"/> was installed after
97 <xref linkend="at-spi2-core"/>, <xref linkend="gdk-pixbuf"/>, and/or
98 <xref linkend="pango"/>, those packages will have to be rebuilt before
99 this package can be built.
100 </para>
101 </note>
102
103 </sect2>
104
105 <sect2 role="installation">
106 <title>Installation of GTK+ 2</title>
107
108 <para>
109 Install <application>GTK+ 2</application> by running the following
110 commands:
111 </para>
112
113<screen><userinput>sed -e 's#l \(gtk-.*\).sgml#&amp; -o \1#' \
114 -i docs/{faq,tutorial}/Makefile.in &amp;&amp;
115
116./configure --prefix=/usr --sysconfdir=/etc &amp;&amp;
117
118make</userinput></screen>
119
120 <para>
121 To test the results, issue: <command>make -k check</command>. Note that you
122 must run the tests from a session with X Window Display capability (i.e.,
123 not a text-based terminal/console) as the tests attempt to open an X
124 window, and the tests can take an excessively long time. Using an X
125 Window, the tests should take less than 0.1 SBU. One test,
126 aliasfilescheck.sh, is known to fail.
127 </para>
128
129 <para>
130 Now, as the <systemitem class="username">root</systemitem> user:
131 </para>
132
133<screen role="root"><userinput>make install</userinput></screen>
134
135 <note>
136 <para>
137 If you installed the package on to your system using a
138 <quote>DESTDIR</quote> method, an important file was not installed and
139 must be copied and/or generated. Generate it using the following
140 command as the <systemitem class="username">root</systemitem> user:
141 </para>
142
143<screen role="root"><userinput>gtk-query-immodules-2.0 --update-cache</userinput></screen>
144 </note>
145
146 </sect2>
147
148 <sect2 role="commands">
149 <title>Command Explanations</title>
150
151 <para>
152 <command>sed -i 's#l \(gtk-.*\).sgml#&amp; -o \1#'
153 docs/{faq,tutorial}/Makefile.in</command>: If you have
154 <xref linkend="docbook-utils"/> installed (specifically, if configure
155 finds <command>db2html</command>) then it will try to use it to rebuild
156 some of its HTML documentation and fail due to bugs in some of the
157 <filename>Makefile</filename>s. This <command>sed</command> fixes the
158 <filename>Makefile</filename>s.
159 </para>
160 <!-- This still seems to have problems with docbook-utils installed.
161 However, since it's already been tagged, I'll leave it alone. -->
162<!--
163 <para>
164 <command>sed -i -e 's#pltcheck.sh#$(NULL)#g' gtk/Makefile.in</command>:
165 This <command>sed</command> disables one test known to fail.
166 Not necessary, if not running the tests.
167 </para>-->
168
169 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
170 href="../../xincludes/gtk-doc-rebuild.xml"/>
171
172 </sect2>
173
174 <sect2 role="configuration">
175 <title>Configuring GTK+ 2</title>
176
177 <sect3 id="gtk2-config">
178 <title>Config Files</title>
179 <para>
180 <filename>~/.gtkrc-2.0</filename>,
181 <filename>/etc/gtk-2.0/gtkrc</filename>, and
182 <filename>/usr/share/gtk-2.0/gtkrc</filename>
183 </para>
184
185 <indexterm zone="gtk2 gtk2-config">
186 <primary sortas="e-AA.gtkrc-2.0">~/.gtkrc-2.0</primary>
187 </indexterm>
188
189 <indexterm zone="gtk2 gtk2-config">
190 <primary sortas="e-etc-gtk-2.0-gtkrc">/etc/gtk-2.0/gtkrc</primary>
191 </indexterm>
192
193 <indexterm zone="gtk2 gtk2-config">
194 <primary sortas="e-usr-share-gtk-2.0-gtkrc">/usr/share/gtk-2.0/gtkrc</primary>
195 </indexterm>
196 </sect3>
197
198 <sect3><title>Configuration Information</title>
199
200 <para>
201 <application>GTK+ 2</application> themes change the way a
202 <application>GTK+ 2</application> application looks. A
203 <application>GTK+ 2</application> icon theme can be used to change the
204 icons that appear on the application's toolbar. If you have installed a
205 <application>GTK+ 2</application> theme (such as
206 <xref linkend="gnome-themes-extra"/> or
207 <xref linkend="gtk-engines"/>), or a
208 <application>GTK+</application> icon theme (such as <xref
209 linkend="adwaita-icon-theme"/>) you can set your preferences in
210 <filename>~/.gtkrc-2.0</filename>:
211 </para>
212
213<screen><userinput>cat &gt; ~/.gtkrc-2.0 &lt;&lt; "EOF"
214<literal>include "/usr/share/themes/<replaceable>Glider</replaceable>/gtk-2.0/gtkrc"
215gtk-icon-theme-name = "<replaceable>hicolor</replaceable>"</literal>
216EOF</userinput></screen>
217
218 <para>
219 There are many more themes available at
220 <ulink url="https://gnome-look.org/">Gnome-Look.org</ulink> and other
221 places.
222 </para>
223
224 <para>
225 Once you've settled on themes you like, you can (as the
226 <systemitem class="username">root</systemitem> user) make them the
227 default system wide:
228 </para>
229
230<screen role="root"><userinput>cat &gt; /etc/gtk-2.0/gtkrc &lt;&lt; "EOF"
231<literal>include "/usr/share/themes/<replaceable>Clearlooks</replaceable>/gtk-2.0/gtkrc"
232gtk-icon-theme-name = "<replaceable>elementary</replaceable>"</literal>
233EOF</userinput></screen>
234
235 <para>
236 <xref linkend="lxappearance"/> is a <application>GTK+ 2</application>
237 application that can help you choose the themes you like.
238 </para>
239 </sect3>
240 </sect2>
241
242 <sect2 role="content">
243 <title>Contents</title>
244
245 <segmentedlist>
246 <segtitle>Installed Programs</segtitle>
247 <segtitle>Installed Libraries</segtitle>
248 <segtitle>Installed Directories</segtitle>
249
250 <seglistitem>
251 <seg>
252 gtk-builder-convert, gtk-demo, gtk-query-immodules-2.0, and
253 gtk-update-icon-cache
254 </seg>
255 <seg>
256 libgailutil.so, libgdk-x11-2.0.so, and libgtk-x11-2.0.so
257 </seg>
258 <seg>
259 /etc/gtk-2.0,
260 /usr/include/{gail-1.0,gtk-2.0,gtk-unix-print-2.0},
261 /usr/lib/gtk-2.0,
262 /usr/share/doc/gtk+-&gtk2-version;,
263 /usr/share/gtk-2.0,
264 /usr/share/gtk-doc/html/{gail-libgail-util,gdk2,gtk2}, and
265 /usr/share/themes/{Default,Emacs,Raleigh}
266 </seg>
267 </seglistitem>
268 </segmentedlist>
269
270 <variablelist>
271 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
272 <?dbfo list-presentation="list"?>
273 <?dbhtml list-presentation="table"?>
274
275 <varlistentry id="gtk-builder-convert">
276 <term><command>gtk-builder-convert</command></term>
277 <listitem>
278 <para>
279 converts glade files into XML files which can be loaded with
280 GtkBuilder
281 </para>
282 <indexterm zone="gtk2 gtk-builder-convert">
283 <primary sortas="b-gtk-builder-convert">gtk-builder-convert</primary>
284 </indexterm>
285 </listitem>
286 </varlistentry>
287
288 <varlistentry id="gtk-demo">
289 <term><command>gtk-demo</command></term>
290 <listitem>
291 <para>
292 demonstrates <application>GTK+ 2</application> functionality and
293 provides code for the examples
294 </para>
295 <indexterm zone="gtk2 gtk-demo">
296 <primary sortas="b-gtk-demo">gtk-demo</primary>
297 </indexterm>
298 </listitem>
299 </varlistentry>
300
301 <varlistentry id="gtk-query-immodules-2.0">
302 <term><command>gtk-query-immodules-2.0</command></term>
303 <listitem>
304 <para>
305 collects information about loadable input method modules for
306 <application>GTK+ 2</application> and writes it to standard output
307 </para>
308 <indexterm zone="gtk2 gtk-query-immodules-2.0">
309 <primary sortas="b-gtk-query-immodules-2.0">gtk-query-immodules-2.0</primary>
310 </indexterm>
311 </listitem>
312 </varlistentry>
313
314 <varlistentry id="gtk-update-icon-cache">
315 <term><command>gtk-update-icon-cache</command></term>
316 <listitem>
317 <para>
318 creates mmap()able cache files for icon themes. Starting with
319 <application>gtk+-2.24.24</application>, add the flag
320 <quote>--include-image-data</quote> to this command, if you wish
321 previous behavior, with image data in the cache
322 </para>
323 <indexterm zone="gtk2 gtk-update-icon-cache">
324 <primary sortas="b-gtk-update-icon-cache">gtk-update-icon-cache</primary>
325 </indexterm>
326 </listitem>
327 </varlistentry>
328
329 <varlistentry id="libgdk-x11-2">
330 <term><filename class="libraryfile">libgdk-x11-2.0.so</filename></term>
331 <listitem>
332 <para>
333 contains functions that act as a wrapper around the low-level
334 drawing and windowing functions provided by the underlying graphics
335 system
336 </para>
337 <indexterm zone="gtk2 libgdk-x11-2">
338 <primary sortas="c-libgdk-x11-2">libgdk-x11-2.0.so</primary>
339 </indexterm>
340 </listitem>
341 </varlistentry>
342
343 <varlistentry id="libgtk-x11-2">
344 <term><filename class="libraryfile">libgtk-x11-2.0.so</filename></term>
345 <listitem>
346 <para>
347 contains functions that provide an API to implement graphical user
348 interfaces
349 </para>
350 <indexterm zone="gtk2 libgtk-x11-2">
351 <primary sortas="c-libgtk-x11-2">libgtk-x11-2.0.so</primary>
352 </indexterm>
353 </listitem>
354 </varlistentry>
355
356 </variablelist>
357
358 </sect2>
359
360</sect1>
Note: See TracBrowser for help on using the repository browser.