source: x/lib/libadwaita.xml@ fbd6311

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 fbd6311 was 9d0d597f, checked in by Bruce Dubbs <bdubbs@…>, 10 months ago

Tag most of Chapter 25.

  • Property mode set to 100644
File size: 5.3 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 libadwaita-download-http "&gnome-download-http;/libadwaita/&libadwaita-minor;/libadwaita-&libadwaita-version;.tar.xz">
8 <!ENTITY libadwaita-download-ftp "&gnome-download-ftp;/libadwaita/&libadwaita-minor;/libadwaita-&libadwaita-version;.tar.xz">
9 <!ENTITY libadwaita-md5sum "80d33605da8d22ebf6bdc8bfd81ad792">
10 <!ENTITY libadwaita-size "3.0 MB">
11 <!ENTITY libadwaita-buildsize "38 MB (with tests)">
12 <!ENTITY libadwaita-time "0.2 SBU (with parallelism=4; with tests)">
13]>
14
15<sect1 id="libadwaita1" xreflabel="libadwaita-&libadwaita-version;">
16 <?dbhtml filename="libadwaita.html"?>
17
18
19 <title>libadwaita-&libadwaita-version;</title>
20
21 <indexterm zone="libadwaita1">
22 <primary sortas="a-libadwaita">libadwaita</primary>
23 </indexterm>
24
25 <sect2 role="package">
26 <title>Introduction to libadwaita</title>
27
28 <para>
29 The <application>libadwaita</application> package provides additional
30 GTK4 UI widgets for use in developing user interfaces. It is used
31 primarily for GNOME 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="&libadwaita-download-http;"/>
41 </para>
42 </listitem>
43 <listitem>
44 <para>
45 Download (FTP): <ulink url="&libadwaita-download-ftp;"/>
46 </para>
47 </listitem>
48 <listitem>
49 <para>
50 Download MD5 sum: &libadwaita-md5sum;
51 </para>
52 </listitem>
53 <listitem>
54 <para>
55 Download size: &libadwaita-size;
56 </para>
57 </listitem>
58 <listitem>
59 <para>
60 Estimated disk space required: &libadwaita-buildsize;
61 </para>
62 </listitem>
63 <listitem>
64 <para>
65 Estimated build time: &libadwaita-time;
66 </para>
67 </listitem>
68 </itemizedlist>
69
70 <bridgehead renderas="sect3">libadwaita Dependencies</bridgehead>
71
72 <bridgehead renderas="sect4">Required</bridgehead>
73 <para role="required">
74 <xref linkend="gtk4"/>
75 </para>
76
77 <bridgehead renderas="sect4">Recommended</bridgehead>
78 <para role="recommended">
79 <xref linkend="vala"/>
80 </para>
81
82 <bridgehead renderas="sect4">Optional</bridgehead>
83 <para role="optional">
84 <xref linkend="gi-docgen"/>
85 </para>
86
87 </sect2>
88
89 <sect2 role="installation">
90 <title>Installation of libadwaita</title>
91
92 <para>
93 Install <application>libadwaita</application> by running the following
94 commands:
95 </para>
96
97<screen><userinput>mkdir build &amp;&amp;
98cd build &amp;&amp;
99
100meson setup --prefix=/usr --buildtype=release .. &amp;&amp;
101ninja</userinput></screen>
102
103 <para>
104 If you have <xref linkend='gi-docgen'/> installed and wish to build
105 the API documentation for this package, issue:
106 </para>
107
108<screen role='nodump'><userinput>sed "s/apiversion/'&libadwaita-version;'/" -i ../doc/meson.build &amp;&amp;
109meson configure -Dgtk_doc=true &amp;&amp;
110ninja</userinput></screen>
111
112 <para>
113 To test the results, issue: <command>ninja test</command>.
114 The tests must be run from a graphical session.
115 </para>
116
117 <para>
118 Now, as the <systemitem class="username">root</systemitem> user:
119 </para>
120
121<screen role="root"><userinput>ninja install</userinput></screen>
122 </sect2>
123
124 <sect2 role="commands">
125 <title>Command Explanations</title>
126
127 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
128 href="../../xincludes/meson-buildtype-release.xml"/>
129
130 </sect2>
131
132 <sect2 role="content">
133 <title>Contents</title>
134
135 <segmentedlist>
136 <segtitle>Installed Programs</segtitle>
137 <segtitle>Installed Libraries</segtitle>
138 <segtitle>Installed Directories</segtitle>
139
140 <seglistitem>
141 <seg>
142 adwaita-1-demo
143 </seg>
144 <seg>
145 libadwaita-1.so
146 </seg>
147 <seg>
148 /usr/include/libadwaita-1
149 </seg>
150 </seglistitem>
151 </segmentedlist>
152
153 <variablelist>
154 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
155 <?dbfo list-presentation="list"?>
156 <?dbhtml list-presentation="table"?>
157
158 <varlistentry id="adwaita-1-demo">
159 <term><command>adwaita-1-demo</command></term>
160 <listitem>
161 <para>
162 provides an example of how to use the
163 <application>libadwaita</application> library
164 </para>
165 <indexterm zone="libadwaita1 adwaita-1-demo">
166 <primary sortas="b-adwaita-1-demo">adwaita-1-demo</primary>
167 </indexterm>
168 </listitem>
169 </varlistentry>
170
171 <varlistentry id="libadwaita-1">
172 <term><filename class="libraryfile">libadwaita-1.so</filename></term>
173 <listitem>
174 <para>
175 provides additional GTK widgets for use in creating user interfaces
176 </para>
177 <indexterm zone="libadwaita1 libadwaita-1">
178 <primary sortas="c-libadwaita-1">libadwaita-1.so</primary>
179 </indexterm>
180 </listitem>
181 </varlistentry>
182 </variablelist>
183 </sect2>
184
185</sect1>
Note: See TracBrowser for help on using the repository browser.