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

<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
   "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
  <!ENTITY % general-entities SYSTEM "../../general.ent">
  %general-entities;

  <!ENTITY at-spi2-core-download-http
           "&gnome-download-http;/at-spi2-core/2.40/at-spi2-core-&at-spi2-core-version;.tar.xz">
  <!ENTITY at-spi2-core-download-ftp
           "&gnome-download-ftp;/at-spi2-core/2.40/at-spi2-core-&at-spi2-core-version;.tar.xz">
  <!ENTITY at-spi2-core-md5sum        "db4f7caceb5d663ec3adb715408b2303">
  <!ENTITY at-spi2-core-size          "196 KB">
  <!ENTITY at-spi2-core-buildsize     "9.8 MB (with tests)">
  <!ENTITY at-spi2-core-time          "less than 0.1 SBU (using parallelism=4, with tests)">
]>

<sect1 id="at-spi2-core" xreflabel="at-spi2-core-&at-spi2-core-version;">
  <?dbhtml filename="at-spi2-core.html"?>

  <sect1info>
    <date>$Date$</date>
  </sect1info>

  <title>at-spi2-core-&at-spi2-core-version;</title>

  <indexterm zone="at-spi2-core">
    <primary sortas="a-at-spi2-core">at-spi2-core</primary>
  </indexterm>

  <sect2 role="package">
    <title>Introduction to At-Spi2 Core</title>

    <para>
      The <application>At-Spi2 Core</application> package is a part of the
      GNOME Accessibility Project. It provides a Service Provider Interface
      for the Assistive Technologies available on the
      <application>GNOME</application> platform and a library against which
      applications can be linked.
    </para>

    &lfs110a_checked;

    <bridgehead renderas="sect3">Package Information</bridgehead>
    <itemizedlist spacing="compact">
      <listitem>
        <para>
          Download (HTTP): <ulink url="&at-spi2-core-download-http;"/>
        </para>
      </listitem>
      <listitem>
        <para>
          Download (FTP): <ulink url="&at-spi2-core-download-ftp;"/>
        </para>
      </listitem>
      <listitem>
        <para>
          Download MD5 sum: &at-spi2-core-md5sum;
        </para>
      </listitem>
      <listitem>
        <para>
          Download size: &at-spi2-core-size;
        </para>
      </listitem>
      <listitem>
        <para>
          Estimated disk space required: &at-spi2-core-buildsize;
        </para>
      </listitem>
      <listitem>
        <para>
          Estimated build time: &at-spi2-core-time;
        </para>
      </listitem>
    </itemizedlist>

    <bridgehead renderas="sect3">At-Spi2 Core Dependencies</bridgehead>

    <bridgehead renderas="sect4">Required</bridgehead>
    <para role="required">
      <xref linkend="dbus"/>,
      <xref linkend="glib2"/>, and
      <xref linkend="xorg7-lib"/>
    </para>

    <bridgehead renderas="sect4">Optional (Required if building GNOME)</bridgehead>
    <para role="optional">
      <xref linkend="gobject-introspection"/>
    </para>

    <bridgehead renderas="sect4">Optional</bridgehead>
    <para role="optional">
      <xref linkend="gtk-doc"/>
    </para>

    <para condition="html" role="usernotes">User Notes:
      <ulink url="&blfs-wiki;/at-spi2-core"/>
    </para>
  </sect2>

  <sect2 role="installation">
    <title>Installation of At-Spi2 Core</title>

    <para>
      Install <application>At-Spi2 Core</application> by running the following
      commands:
    </para>

<screen revision="sysv"><userinput>mkdir build &amp;&amp;
cd    build &amp;&amp;

meson --prefix=/usr       \
      --buildtype=release \
      -Dsystemd_user_dir=/tmp .. &amp;&amp;
ninja</userinput></screen>

<screen revision="systemd"><userinput>mkdir build &amp;&amp;
cd    build &amp;&amp;

meson --prefix=/usr --buildtype=release .. &amp;&amp;
ninja</userinput></screen>

    <para>
      A session bus address, normally available in an Xorg terminal,
      is necessary to run the tests. And, the test suite requires the
      glib schemas of the package already installed. To test the results,
      install the package first, then issue: <command>ninja test</command>.
      The memory test is known to timeout.
    </para>
<!-- [pierre Sep 5th, 2020] the memory test passed for me with 2.36.1. -->
    <para>
      Now, as the <systemitem class="username">root</systemitem> user:
    </para>

<screen role="root" revision="systemd"><userinput>ninja install</userinput></screen>
<screen role="root" revision="sysv"><userinput>ninja install &amp;&amp;
rm /tmp/at-spi-dbus-bus.service</userinput></screen>

  </sect2>


  <sect2 role="commands" revision="sysv">
    <title>Command Explanations</title>

    <!-- <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
       href="../../xincludes/gtk-doc-rebuild.xml"/> -->

    <para>
      <parameter>-Dsystemd_user_dir=/tmp</parameter>: This flag puts the
      systemd unit file in /tmp where it will be removed. SysV, is unable to
      use this file.
    </para>

  </sect2>

  <sect2 role="commands">
    <title>Command Explanations</title>

    <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
      href="../../xincludes/meson-buildtype-release.xml"/>

  </sect2>

  <sect2 role="content">
    <title>Contents</title>

    <segmentedlist>
      <segtitle>Installed Programs</segtitle>
      <segtitle>Installed Library</segtitle>
      <segtitle>Installed Directories</segtitle>

      <seglistitem>
        <!-- <seg> No user executable programs
          at-spi-bus-launcher and at-spi2-registryd in /usr/libexec
        </seg> -->
        <seg>
          None
        </seg>
        <seg>
          libatspi.so
        </seg>
        <seg>
          /usr/include/at-spi-2.0,
          /usr/share/defaults/at-spi2, and
          /usr/share/gtk-doc/html/libatspi
        </seg>
      </seglistitem>
    </segmentedlist>

    <variablelist>
      <bridgehead renderas="sect3">Short Descriptions</bridgehead>
      <?dbfo list-presentation="list"?>
      <?dbhtml list-presentation="table"?>

    <!-- Not user executable programs
      <varlistentry id="at-spi2-registryd">
        <term><command>at-spi2-registryd</command></term>
        <listitem>
          <para>
            is the <application>At-Spi2</application> registry daemon.
          </para>
          <indexterm zone="at-spi2-core at-spi2-registryd">
            <primary sortas="b-at-spi2-registryd">at-spi2-registryd</primary>
          </indexterm>
        </listitem>
      </varlistentry>
    -->

      <varlistentry id="libatspi">
        <term><filename class="libraryfile">libatspi.so</filename></term>
        <listitem>
          <para>
            contains the <application>At-Spi2</application> API functions
          </para>
          <indexterm zone="at-spi2-core libatspi">
            <primary sortas="c-libatspi">libatspi.so</primary>
          </indexterm>
        </listitem>
      </varlistentry>

    </variablelist>

  </sect2>

</sect1>