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

12.1 ken/TL2024 lazarus trunk xry111/llvm18
Last change on this file since f67c5c8 was 1241ea19, checked in by Bruce Dubbs <bdubbs@…>, 3 months ago

Tag xfce and dependencies
  • Property mode set to 100644
File size: 8.3 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"/>,
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 (Required if building GNOME)</bridgehead>
86 <para role="optional">
87 <xref linkend="gobject-introspection"/>
88 </para>
89
90 <bridgehead renderas="sect4">Optional</bridgehead>
91 <para role="optional">
92 <xref linkend="gi-docgen"/> and <xref linkend='sphinx'/>
93 </para>
94
95 </sect2>
96
97 <sect2 role="installation">
98 <title>Installation of At-Spi2 Core</title>
99
100 <para>
101 Install <application>At-Spi2 Core</application> by running the following
102 commands:
103 </para>
104
105<screen revision="sysv"><userinput>mkdir build &amp;&amp;
106cd build &amp;&amp;
107
108meson setup .. \
109 --prefix=/usr \
110 --buildtype=release \
111 -Dsystemd_user_dir=/tmp &amp;&amp;
112ninja</userinput></screen>
113
114<screen revision="systemd"><userinput>mkdir build &amp;&amp;
115cd build &amp;&amp;
116
117meson setup --prefix=/usr --buildtype=release .. &amp;&amp;
118ninja</userinput></screen>
119
120 <para>
121 The test suite also requires the glib schemas of the package to be
122 installed already. To test the results, install the package first,
123 then issue: <command>dbus-run-session ninja test</command>.
124 One test, <filename>atk-test</filename>, is known to timeout on some
125 systems.
126 </para>
127
128 <para>
129 Now, as the <systemitem class="username">root</systemitem> user:
130 </para>
131
132<screen role="root" revision="systemd"><userinput>ninja install</userinput></screen>
133<screen role="root" revision="sysv"><userinput>ninja install &amp;&amp;
134rm /tmp/at-spi-dbus-bus.service</userinput></screen>
135
136 </sect2>
137
138 <sect2 role="commands">
139 <title>Command Explanations</title>
140
141 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
142 href="../../xincludes/meson-buildtype-release.xml"/>
143
144 <para revision="sysv">
145 <parameter>-Dsystemd_user_dir=/tmp</parameter>: This flag puts the
146 systemd unit file in /tmp where it will be removed. SysV is unable to
147 use this file.
148 </para>
149
150 <para>
151 <option>-Ddocs=true</option>: Use this switch if you want to build the
152 documentation. Note that you must have both
153 <xref role="nodep" linkend="gi-docgen"/>
154 and <xref linkend='sphinx'/> installed on your system.
155 </para>
156
157 <!-- For when we remove gtk2 from the book:
158 <para>
159 <parameter>-Dgtk2_atk_adaptor=false</parameter>: This switch disables
160 building the GTK+-2 module for this package.
161 </para>
162 -->
163
164 </sect2>
165
166 <sect2 role="content">
167 <title>Contents</title>
168
169 <segmentedlist>
170 <segtitle>Installed Programs</segtitle>
171 <segtitle>Installed Library</segtitle>
172 <segtitle>Installed Directories</segtitle>
173
174 <seglistitem>
175 <!-- <seg> No user executable programs
176 at-spi-bus-launcher and at-spi2-registryd in /usr/libexec
177 </seg> -->
178 <seg>
179 None
180 </seg>
181 <seg>
182 libatk-1.0.so,
183 libatk-bridge-2.0.so,
184 libatspi.so, and
185 /usr/lib/gtk-2.0/modules/libatk-bridge.so
186 </seg>
187 <seg>
188 /usr/include/atk-1.0,
189 /usr/include/at-spi-2.0,
190 /usr/include/at-spi2-atk,
191 /usr/lib/gnome-settings-daemon-3.0,
192 /usr/share/defaults/at-spi2, and
193 /usr/share/gtk-doc/html/libatspi (optional)
194 </seg>
195 </seglistitem>
196 </segmentedlist>
197
198 <variablelist>
199 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
200 <?dbfo list-presentation="list"?>
201 <?dbhtml list-presentation="table"?>
202
203 <!-- Not user executable programs
204 <varlistentry id="at-spi2-registryd">
205 <term><command>at-spi2-registryd</command></term>
206 <listitem>
207 <para>
208 is the <application>At-Spi2</application> registry daemon.
209 </para>
210 <indexterm zone="at-spi2-core at-spi2-registryd">
211 <primary sortas="b-at-spi2-registryd">at-spi2-registryd</primary>
212 </indexterm>
213 </listitem>
214 </varlistentry>
215 -->
216
217 <varlistentry id="libatk-1.0">
218 <term><filename class="libraryfile">libatk-1.0.so</filename></term>
219 <listitem>
220 <para>
221 contains functions that are used by assistive technologies to
222 interact with desktop applications
223 </para>
224 <indexterm zone="at-spi2-core libatk-1.0">
225 <primary sortas="c-libatk-1.0">libatk-1.0.so</primary>
226 </indexterm>
227 </listitem>
228 </varlistentry>
229
230 <varlistentry id="libatk-bridge">
231 <term><filename class="libraryfile">libatk-bridge.so</filename></term>
232 <listitem>
233 <para>
234 contains the Accessibility Toolkit GTK+-2 bridge
235 </para>
236 <indexterm zone="at-spi2-core libatk-bridge">
237 <primary sortas="c-libatk-bridge">libatk-bridge.so</primary>
238 </indexterm>
239 </listitem>
240 </varlistentry>
241
242 <varlistentry id="libatk-bridge-2.0">
243 <term><filename class="libraryfile">libatk-bridge-2.0.so</filename></term>
244 <listitem>
245 <para>
246 contains the Accessibility Toolkit GTK+ module
247 </para>
248 <indexterm zone="at-spi2-core libatk-bridge-2.0">
249 <primary sortas="c-libatk-bridge-2.0">libatk-bridge-2.0.so</primary>
250 </indexterm>
251 </listitem>
252 </varlistentry>
253
254 <varlistentry id="libatspi">
255 <term><filename class="libraryfile">libatspi.so</filename></term>
256 <listitem>
257 <para>
258 contains the <application>At-Spi2</application> API functions
259 </para>
260 <indexterm zone="at-spi2-core libatspi">
261 <primary sortas="c-libatspi">libatspi.so</primary>
262 </indexterm>
263 </listitem>
264 </varlistentry>
265
266 </variablelist>
267
268 </sect2>
269
270</sect1>
Note: See TracBrowser for help on using the repository browser.