source: x/lib/at-spi2-core.xml@ c0bc0a9

ken/TL2024 lazarus trunk
Last change on this file since c0bc0a9 was c0bc0a9, checked in by Xi Ruoyao <xry111@…>, 2 months ago

Update to glib-2.80.0 and gobject-introspection-1.80.0

Merge gobject-introspection into glib page to better handle a circular
dependency between these two packages.
  • Property mode set to 100644
File size: 8.2 KB
Line 
1<?xml version="1.0" encoding="UTF-8"?>
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 at-spi2-core-download-http
8 "&gnome-download-http;/at-spi2-core/2.50/at-spi2-core-&at-spi2-core-version;.tar.xz">
9 <!ENTITY at-spi2-core-download-ftp " ">
10 <!ENTITY at-spi2-core-md5sum "14a15f1087292f18a1ab02c2bdd0ce53">
11 <!ENTITY at-spi2-core-size "556 KB">
12 <!ENTITY at-spi2-core-buildsize "24 MB (with tests)">
13 <!ENTITY at-spi2-core-time "0.2 SBU (with tests)">
14]>
15
16<sect1 id="at-spi2-core" xreflabel="at-spi2-core-&at-spi2-core-version;">
17 <?dbhtml filename="at-spi2-core.html"?>
18
19
20 <title>at-spi2-core-&at-spi2-core-version;</title>
21
22 <indexterm zone="at-spi2-core">
23 <primary sortas="a-at-spi2-core">at-spi2-core</primary>
24 </indexterm>
25
26 <sect2 role="package">
27 <title>Introduction to At-Spi2 Core</title>
28
29 <para>
30 The <application>At-Spi2 Core</application> package contains a
31 comprehensive accessibility framework for the Assistive Technologies
32 available on the <application>GNOME</application> platform. This includes
33 a set of interfaces which are implemented by other toolkits and
34 applications.
35 </para>
36
37 &lfs121_checked;
38
39 <bridgehead renderas="sect3">Package Information</bridgehead>
40 <itemizedlist spacing="compact">
41 <listitem>
42 <para>
43 Download (HTTP): <ulink url="&at-spi2-core-download-http;"/>
44 </para>
45 </listitem>
46 <listitem>
47 <para>
48 Download (FTP): <ulink url="&at-spi2-core-download-ftp;"/>
49 </para>
50 </listitem>
51 <listitem>
52 <para>
53 Download MD5 sum: &at-spi2-core-md5sum;
54 </para>
55 </listitem>
56 <listitem>
57 <para>
58 Download size: &at-spi2-core-size;
59 </para>
60 </listitem>
61 <listitem>
62 <para>
63 Estimated disk space required: &at-spi2-core-buildsize;
64 </para>
65 </listitem>
66 <listitem>
67 <para>
68 Estimated build time: &at-spi2-core-time;
69 </para>
70 </listitem>
71 </itemizedlist>
72
73 <bridgehead renderas="sect3">At-Spi2 Core Dependencies</bridgehead>
74
75 <bridgehead renderas="sect4">Required</bridgehead>
76 <para role="required">
77 <xref linkend="dbus"/>,
78 <xref linkend="glib2"/> (GObject Introspection required for GNOME),
79 <!-- Reports "Cannot get the default GSettingsSchemaSource" on
80 startup w/o it. -->
81 <xref role="runtime" linkend="gsettings-desktop-schemas"/> (Runtime),
82 and <xref linkend="xorg7-lib"/>
83 </para>
84
85 <bridgehead renderas="sect4">Optional</bridgehead>
86 <para role="optional">
87 <xref linkend="gi-docgen"/> and <xref linkend='sphinx'/>
88 </para>
89
90 </sect2>
91
92 <sect2 role="installation">
93 <title>Installation of At-Spi2 Core</title>
94
95 <para>
96 Install <application>At-Spi2 Core</application> by running the following
97 commands:
98 </para>
99
100<screen revision="sysv"><userinput>mkdir build &amp;&amp;
101cd build &amp;&amp;
102
103meson setup .. \
104 --prefix=/usr \
105 --buildtype=release \
106 -Dsystemd_user_dir=/tmp &amp;&amp;
107ninja</userinput></screen>
108
109<screen revision="systemd"><userinput>mkdir build &amp;&amp;
110cd build &amp;&amp;
111
112meson setup --prefix=/usr --buildtype=release .. &amp;&amp;
113ninja</userinput></screen>
114
115 <para>
116 The test suite also requires the glib schemas of the package to be
117 installed already. To test the results, install the package first,
118 then issue: <command>dbus-run-session ninja test</command>.
119 One test, <filename>atk-test</filename>, is known to timeout on some
120 systems.
121 </para>
122
123 <para>
124 Now, as the <systemitem class="username">root</systemitem> user:
125 </para>
126
127<screen role="root" revision="systemd"><userinput>ninja install</userinput></screen>
128<screen role="root" revision="sysv"><userinput>ninja install &amp;&amp;
129rm /tmp/at-spi-dbus-bus.service</userinput></screen>
130
131 </sect2>
132
133 <sect2 role="commands">
134 <title>Command Explanations</title>
135
136 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
137 href="../../xincludes/meson-buildtype-release.xml"/>
138
139 <para revision="sysv">
140 <parameter>-Dsystemd_user_dir=/tmp</parameter>: This flag puts the
141 systemd unit file in /tmp where it will be removed. SysV is unable to
142 use this file.
143 </para>
144
145 <para>
146 <option>-Ddocs=true</option>: Use this switch if you want to build the
147 documentation. Note that you must have both
148 <xref role="nodep" linkend="gi-docgen"/>
149 and <xref linkend='sphinx'/> installed on your system.
150 </para>
151
152 <!-- For when we remove gtk2 from the book:
153 <para>
154 <parameter>-Dgtk2_atk_adaptor=false</parameter>: This switch disables
155 building the GTK+-2 module for this package.
156 </para>
157 -->
158
159 </sect2>
160
161 <sect2 role="content">
162 <title>Contents</title>
163
164 <segmentedlist>
165 <segtitle>Installed Programs</segtitle>
166 <segtitle>Installed Library</segtitle>
167 <segtitle>Installed Directories</segtitle>
168
169 <seglistitem>
170 <!-- <seg> No user executable programs
171 at-spi-bus-launcher and at-spi2-registryd in /usr/libexec
172 </seg> -->
173 <seg>
174 None
175 </seg>
176 <seg>
177 libatk-1.0.so,
178 libatk-bridge-2.0.so,
179 libatspi.so, and
180 /usr/lib/gtk-2.0/modules/libatk-bridge.so
181 </seg>
182 <seg>
183 /usr/include/atk-1.0,
184 /usr/include/at-spi-2.0,
185 /usr/include/at-spi2-atk,
186 /usr/lib/gnome-settings-daemon-3.0,
187 /usr/share/defaults/at-spi2, and
188 /usr/share/gtk-doc/html/libatspi (optional)
189 </seg>
190 </seglistitem>
191 </segmentedlist>
192
193 <variablelist>
194 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
195 <?dbfo list-presentation="list"?>
196 <?dbhtml list-presentation="table"?>
197
198 <!-- Not user executable programs
199 <varlistentry id="at-spi2-registryd">
200 <term><command>at-spi2-registryd</command></term>
201 <listitem>
202 <para>
203 is the <application>At-Spi2</application> registry daemon.
204 </para>
205 <indexterm zone="at-spi2-core at-spi2-registryd">
206 <primary sortas="b-at-spi2-registryd">at-spi2-registryd</primary>
207 </indexterm>
208 </listitem>
209 </varlistentry>
210 -->
211
212 <varlistentry id="libatk-1.0">
213 <term><filename class="libraryfile">libatk-1.0.so</filename></term>
214 <listitem>
215 <para>
216 contains functions that are used by assistive technologies to
217 interact with desktop applications
218 </para>
219 <indexterm zone="at-spi2-core libatk-1.0">
220 <primary sortas="c-libatk-1.0">libatk-1.0.so</primary>
221 </indexterm>
222 </listitem>
223 </varlistentry>
224
225 <varlistentry id="libatk-bridge">
226 <term><filename class="libraryfile">libatk-bridge.so</filename></term>
227 <listitem>
228 <para>
229 contains the Accessibility Toolkit GTK+-2 bridge
230 </para>
231 <indexterm zone="at-spi2-core libatk-bridge">
232 <primary sortas="c-libatk-bridge">libatk-bridge.so</primary>
233 </indexterm>
234 </listitem>
235 </varlistentry>
236
237 <varlistentry id="libatk-bridge-2.0">
238 <term><filename class="libraryfile">libatk-bridge-2.0.so</filename></term>
239 <listitem>
240 <para>
241 contains the Accessibility Toolkit GTK+ module
242 </para>
243 <indexterm zone="at-spi2-core libatk-bridge-2.0">
244 <primary sortas="c-libatk-bridge-2.0">libatk-bridge-2.0.so</primary>
245 </indexterm>
246 </listitem>
247 </varlistentry>
248
249 <varlistentry id="libatspi">
250 <term><filename class="libraryfile">libatspi.so</filename></term>
251 <listitem>
252 <para>
253 contains the <application>At-Spi2</application> API functions
254 </para>
255 <indexterm zone="at-spi2-core libatspi">
256 <primary sortas="c-libatspi">libatspi.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.