source: x/lib/gtk4.xml@ 6a4996f

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 6a4996f was 6a4996f, checked in by Douglas R. Reno <renodr@…>, 17 months ago

Update to gtk-4.4.0 (and some tags)

  • Property mode set to 100644
File size: 15.0 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 gtk4-download-http "&gnome-download-http;/gtk/4.4/gtk-&gtk4-version;.tar.xz">
8 <!ENTITY gtk4-download-ftp "&gnome-download-ftp;/gtk/4.4/gtk-&gtk4-version;.tar.xz">
9 <!ENTITY gtk4-md5sum "113d24bd311037f774bf1aa7d5d0a344">
10 <!ENTITY gtk4-size "29 MB">
11 <!ENTITY gtk4-buildsize "670 MB (76 MB installed, add 10 MB for tests)">
12 <!ENTITY gtk4-time "1.1 SBU (using parallelism=4, add 0.5 SBU for tests)">
13]>
14
15<sect1 id="gtk4" xreflabel="GTK-&gtk4-version;">
16 <?dbhtml filename="gtk4.html"?>
17
18 <sect1info>
19 <date>$Date$</date>
20 </sect1info>
21
22 <title>GTK-&gtk4-version;</title>
23
24 <indexterm zone="gtk4">
25 <primary sortas="a-gtk4">GTK-4</primary>
26 </indexterm>
27
28 <sect2 role="package">
29 <title>Introduction to GTK 4</title>
30
31 <para>
32 The <application>GTK 4</application> package contains libraries used for
33 creating graphical user interfaces for applications.
34 </para>
35
36 &lfs110a_checked;
37
38 <bridgehead renderas="sect3">Package Information</bridgehead>
39 <itemizedlist spacing="compact">
40 <listitem>
41 <para>
42 Download (HTTP): <ulink url="&gtk4-download-http;"/>
43 </para>
44 </listitem>
45 <listitem>
46 <para>
47 Download (FTP): <ulink url="&gtk4-download-ftp;"/>
48 </para>
49 </listitem>
50 <listitem>
51 <para>
52 Download MD5 sum: &gtk4-md5sum;
53 </para>
54 </listitem>
55 <listitem>
56 <para>
57 Download size: &gtk4-size;
58 </para>
59 </listitem>
60 <listitem>
61 <para>
62 Estimated disk space required: &gtk4-buildsize;
63 </para>
64 </listitem>
65 <listitem>
66 <para>
67 Estimated build time: &gtk4-time;
68 </para>
69 </listitem>
70 </itemizedlist>
71
72 <bridgehead renderas="sect3">GTK 4 Dependencies</bridgehead>
73
74 <bridgehead renderas="sect4">Required</bridgehead>
75 <para role="required">
76 <xref linkend="fribidi"/>,
77 <xref linkend="gdk-pixbuf"/>,
78 <xref linkend="graphene"/>,
79 <xref linkend="iso-codes"/>,
80 <xref linkend="libepoxy"/>,
81 <xref linkend="libxkbcommon"/>,
82 <xref linkend="pango"/>,
83 <xref linkend="wayland-protocols"/>,
84 </para>
85
86 <bridgehead renderas="sect4">Recommended</bridgehead>
87 <para role="recommended">
88 <xref linkend="adwaita-icon-theme"/> (default for some gtk4 settings keys),
89 <xref linkend="ffmpeg"/>,
90 <xref linkend="gst10-plugins-bad"/>,
91 <xref linkend="hicolor-icon-theme"/> (needed for tests and for defaults), and
92 <xref linkend="librsvg"/>
93 </para>
94
95 <bridgehead renderas="sect4">Recommended (Required if building GNOME)</bridgehead>
96 <para role="recommended">
97 <xref linkend="gobject-introspection"/>
98 </para>
99
100 <bridgehead renderas="sect4">Optional</bridgehead>
101 <para role="optional">
102 <xref linkend="colord"/>,
103 <xref linkend="cups"/>,
104 <xref linkend="gtk-doc"/>,
105 <xref role="runtime" linkend="highlight"/>
106 (runtime, only used by <command>gtk4-demo</command> for syntax
107 highlighting of demo source code),
108 <xref linkend="json-glib"/>,
109 <xref linkend="rest"/>,
110 <xref linkend="sassc"/>,
111 <xref linkend="tracker3"/>,
112 <ulink url="https://gitlab.gnome.org/ebassi/gi-docgen">gi-docgen</ulink>,
113 <ulink url="https://gitlab.gnome.org/World/libcloudproviders">libcloudproviders</ulink>, and
114 <ulink url="https://vulkan.lunarg.com/sdk/home">vulkan</ulink>
115 </para>
116
117 <para condition="html" role="usernotes">
118 User Notes: <ulink url="&blfs-wiki;/gtk4"/>
119 </para>
120 </sect2>
121
122 <sect2 role="installation">
123 <title>Installation of GTK 4</title>
124
125 <para>
126 Install <application>GTK 4</application> by running the following
127 commands:
128 </para>
129
130<screen><userinput>mkdir build &amp;&amp;
131cd build &amp;&amp;
132
133meson --prefix=/usr --buildtype=release -Dbroadway_backend=true .. &amp;&amp;
134ninja</userinput></screen>
135
136 <para>
137 To run the tests, issue: <command>meson test --setup x11</command>. If you
138 are in a Wayland session, replace x11 with wayland. 8 tests are known to
139 fail, out of 730.
140 </para>
141
142 <para>
143 Now, as the <systemitem class="username">root</systemitem> user:
144 </para>
145
146<screen role="root"><userinput>ninja install</userinput></screen>
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 <para>
156 <parameter>-Dbroadway_backend=true</parameter>: This switch enables the
157 HTML5 GDK backend.
158 </para>
159
160 <para>
161 <option>-Dcloudproviders=enabled</option>: Use this switch if you have
162 <ulink url="https://gitlab.gnome.org/World/libcloudproviders">libcloudproviders</ulink>
163 installed and wish to enable support for cloud providers in a file
164 chooser window.
165 </para>
166
167 <para>
168 <option>-Dsysprof=enabled</option>: Use this switch if you have
169 <xref linkend="sysprof"/> installed and wish to enable tracing support for
170 GTK4-based applications.
171 </para>
172
173 <para>
174 <option>-Dtracker=enabled</option>: Use this switch if you have
175 <xref linkend="tracker3"/> installed and wish to use search functionality
176 when running a file chooser.
177 </para>
178
179 <para>
180 <option>-Dcolord=enabled</option>: Use this switch if you have
181 <xref linkend="colord"/> installed and wish to use colord with the CUPS
182 printing backend.
183 </para>
184
185 <para>
186 <option>-Dsassc=enabled</option>: Use this switch if you have
187 <xref linkend="sassc"/> installed and wish to rebuild the themes.
188 </para>
189
190 <para>
191 <option>-Dgtk_doc=true</option>: Use this switch if you have
192 <xref linkend="gtk-doc"/> installed and wish to generate the API
193 reference documentation.
194 </para>
195
196 </sect2>
197
198 <!--Optional section-->
199 <sect2 role="configuration">
200 <title>Configuring GTK 4</title>
201
202 <sect3 id="gtk4-config">
203 <title>Config Files</title>
204 <para>
205 <filename>~/.config/gtk-4.0/settings.ini</filename> and
206 <filename>/usr/share/gtk-4.0/settings.ini</filename>
207 </para>
208
209 <indexterm zone="gtk4 gtk4-config">
210 <primary sortas="e-AA.home-gtk4-settings.ini">~/.config/gtk-4.0/settings.ini</primary>
211 </indexterm>
212
213 <indexterm zone="gtk4 gtk4-config">
214 <primary
215 sortas="e-usr-share-path-settings.ini">/usr/share/gtk-4.0/settings.ini</primary>
216 </indexterm>
217 </sect3>
218
219 <sect3><title>Configuration Information</title>
220
221 <para>
222 <application>GTK 4</application> themes change the way a
223 <application>GTK 4</application> application looks. An icon theme can
224 be used to change the icons that appear on the application's toolbar.
225 If you have installed a <application>GTK 4</application> theme (e.g.
226 the Adwaita theme built in <application>GTK 4</application>),
227 an icon theme (such as <xref linkend="oxygen-icons5"/>) and/or a font
228 (<xref linkend="dejavu-fonts"/>), you can set your preferences in
229 <filename>~/.config/gtk-4.0/settings.ini</filename>, or the default
230 system-wide configuration file (as the
231 <systemitem class="username">root</systemitem> user), in
232 <filename>/usr/share/gtk-4.0/settings.ini</filename>. For the local
233 user, an example is:
234 </para>
235
236<screen><userinput>mkdir -pv ~/.config/gtk-4.0
237cat &gt; ~/.config/gtk-4.0/settings.ini &lt;&lt; "EOF"
238<literal>[Settings]
239gtk-theme-name = <replaceable>Adwaita</replaceable>
240gtk-icon-theme-name = <replaceable>oxygen</replaceable>
241gtk-font-name = <replaceable>DejaVu Sans 12</replaceable>
242gtk-cutsor-theme-size = <replaceable>18</replaceable>
243gtk-xft-antialias = <replaceable>1</replaceable>
244gtk-xft-hinting = <replaceable>1</replaceable>
245gtk-xft-hintstyle = <replaceable>hintslight</replaceable>
246gtk-xft-rgba = <replaceable>rgb</replaceable>
247gtk-cursor-theme-name = <replaceable>Adwaita</replaceable></literal>
248EOF</userinput></screen>
249
250 <para>
251 There are many settings keys, some with default values. You can find
252 them at <ulink
253 url="https://developer.gnome.org/gtk4/stable/GtkSettings.html">Settings:
254 GTK 4 Reference Manual</ulink>.
255 </para>
256
257 </sect3>
258 </sect2>
259
260 <sect2 role="content">
261 <title>Contents</title>
262
263 <segmentedlist>
264 <segtitle>Installed Programs</segtitle>
265 <segtitle>Installed Libraries</segtitle>
266 <segtitle>Installed Directories</segtitle>
267
268 <seglistitem>
269 <seg>
270 gtk4-broadwayd,
271 gtk4-builder-tool,
272 gtk4-demo,
273 gtk4-demo-application,
274 gtk4-encode-symbolic-svg,
275 gtk4-icon-browser,
276 gtk4-launch,
277 gtk4-print-editor,
278 gtk4-query-settings,
279 gtk4-update-icon-cache, and
280 gtk4-widget-factory
281 </seg>
282 <seg>
283 libgtk-4.so
284 </seg>
285 <seg>
286 /usr/include/gtk-4.0,
287 /usr/lib/gtk-4.0, and
288 /usr/share/gtk-4.0
289 </seg>
290 </seglistitem>
291 </segmentedlist>
292
293 <variablelist>
294 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
295 <?dbfo list-presentation="list"?>
296 <?dbhtml list-presentation="table"?>
297
298 <varlistentry id="gtk4-broadwayd">
299 <term><command>gtk4-broadwayd</command></term>
300 <listitem>
301 <para>
302 provides support for displaying GTK 4 applications in a web
303 browser using HTML5 and web sockets
304 </para>
305 <indexterm zone="gtk4 gtk4-broadwayd">
306 <primary sortas="b-gtk4-broadwayd">gtk4-broadwayd</primary>
307 </indexterm>
308 </listitem>
309 </varlistentry>
310
311 <varlistentry id="gtk4-builder-tool">
312 <term><command>gtk4-builder-tool</command></term>
313 <listitem>
314 <para>
315 performs various operations on GtkBuilder .ui files
316 </para>
317 <indexterm zone="gtk4 gtk4-builder-tool">
318 <primary sortas="b-gtk4-builder-tool">gtk4-builder-tool</primary>
319 </indexterm>
320 </listitem>
321 </varlistentry>
322
323 <varlistentry id="gtk4-demo">
324 <term><command>gtk4-demo</command></term>
325 <listitem>
326 <para>
327 is a simple program that demonstrates some of the tasks that can be
328 done with GTK 4
329 </para>
330 <indexterm zone="gtk4 gtk4-demo">
331 <primary sortas="b-gtk4-demo">gtk4-demo</primary>
332 </indexterm>
333 </listitem>
334 </varlistentry>
335
336 <varlistentry id="gtk4-demo-application">
337 <term><command>gtk4-demo-application</command></term>
338 <listitem>
339 <para>
340 is a simple GTK 4 application which is useful for testing
341 </para>
342 <indexterm zone="gtk4 gtk4-demo-application">
343 <primary sortas="b-gtk4-demo-application">gtk4-demo-application</primary>
344 </indexterm>
345 </listitem>
346 </varlistentry>
347
348 <varlistentry id="gtk4-encode-symbolic-svg">
349 <term><command>gtk4-encode-symbolic-svg</command></term>
350 <listitem>
351 <para>
352 converts symbolic SVG icons into special PNG files. GTK 4 can load
353 and recolor these PNGs, just like original SVGs, but loading them
354 is much faster
355 </para>
356 <indexterm zone="gtk4 gtk4-encode-symbolic-svg">
357 <primary sortas="b-gtk4-encode-symbolic-svg">gtk4-encode-symbolic-svg</primary>
358 </indexterm>
359 </listitem>
360 </varlistentry>
361
362 <varlistentry id="gtk4-icon-browser">
363 <term><command>gtk4-icon-browser</command></term>
364 <listitem>
365 <para>
366 is a utility to explore the icons in the current icon theme. It
367 shows icons in various sizes, their symbolic variants when
368 available, as well as a description of the icon and its context
369 </para>
370 <indexterm zone="gtk4 gtk4-icon-browser">
371 <primary sortas="b-gtk4-icon-browser">gtk4-icon-browser</primary>
372 </indexterm>
373 </listitem>
374 </varlistentry>
375
376 <varlistentry id="gtk4-launch">
377 <term><command>gtk4-launch</command></term>
378 <listitem>
379 <para>
380 launches an application using the given name. The name should match
381 the application .desktop file name (as seen in
382 <filename class="directory">/usr/share/applications</filename>),
383 with or without the '.desktop' extension
384 </para>
385 <indexterm zone="gtk4 gtk-launch">
386 <primary sortas="b-gtk4-launch">gtk4-launch</primary>
387 </indexterm>
388 </listitem>
389 </varlistentry>
390
391 <varlistentry id="gtk4-print-editor">
392 <term><command>gtk4-print-editor</command></term>
393 <listitem>
394 <para>
395 is a simple program to demonstrate printing using GTK 4
396 applications
397 </para>
398 <indexterm zone="gtk4 gtk4-print-editor">
399 <primary sortas="b-gtk4-print-editor">gtk4-print-editor</primary>
400 </indexterm>
401 </listitem>
402 </varlistentry>
403
404 <varlistentry id="gtk4-query-settings">
405 <term><command>gtk4-query-settings</command></term>
406 <listitem>
407 <para>
408 provides a complete listing of all settings related to GTK 4
409 </para>
410 <indexterm zone="gtk4 gtk4-query-settings">
411 <primary sortas="b-gtk4-query-settings">gtk4-query-settings</primary>
412 </indexterm>
413 </listitem>
414 </varlistentry>
415
416 <varlistentry id="gtk4-update-icon-cache">
417 <term><command>gtk4-update-icon-cache</command></term>
418 <listitem>
419 <para>
420 is an icon theme caching utility that creates mmap()able cache
421 files for icon themes
422 </para>
423 <indexterm zone="gtk4 gtk4-update-icon-cache">
424 <primary sortas="b-gtk4-update-icon-cache">gtk4-update-icon-cache</primary>
425 </indexterm>
426 </listitem>
427 </varlistentry>
428
429 <varlistentry id="gtk4-widget-factory">
430 <term><command>gtk4-widget-factory</command></term>
431 <listitem>
432 <para>
433 is a program to view GTK 4 themes and widgets
434 </para>
435 <indexterm zone="gtk4 gtk4-widget-factory">
436 <primary sortas="b-gtk4-widget-factory">gtk4-widget-factory</primary>
437 </indexterm>
438 </listitem>
439 </varlistentry>
440
441 <varlistentry id="libgtk-4">
442 <term><filename class="libraryfile">libgtk-4.so</filename></term>
443 <listitem>
444 <para>
445 contains functions that provide an API to implement graphical user
446 interfaces
447 </para>
448 <indexterm zone="gtk4 libgtk-4">
449 <primary sortas="c-libgtk-4">libgtk-4.so</primary>
450 </indexterm>
451 </listitem>
452 </varlistentry>
453 </variablelist>
454 </sect2>
455</sect1>
Note: See TracBrowser for help on using the repository browser.