source: x/lib/libnotify.xml@ 18aa9339

<?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 libnotify-download-http "&gnome-download-http;/libnotify/0.8/libnotify-&libnotify-version;.tar.xz">
  <!ENTITY libnotify-download-ftp  "&gnome-download-ftp;/libnotify/0.8/libnotify-&libnotify-version;.tar.xz">
  <!ENTITY libnotify-md5sum        "1495f279b255b4493ac3588559823158">
  <!ENTITY libnotify-size          "104 KB">
  <!ENTITY libnotify-buildsize     "2.5 MB">
  <!ENTITY libnotify-time          "0.1 SBU">
]>

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


  <title>libnotify-&libnotify-version;</title>

  <indexterm zone="libnotify">
    <primary sortas="a-libnotify">libnotify</primary>
  </indexterm>

  <sect2 role="package">
    <title>Introduction to libnotify</title>

    <para>
      The <application>libnotify</application> library is used to send desktop
      notifications to a notification daemon, as defined in the Desktop
      Notifications spec. These notifications can be used to inform the user about
      an event or display some form of information without getting in the user's
      way.
    </para>

    &lfs112_checked;

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

    <bridgehead renderas="sect3">libnotify Dependencies</bridgehead>

    <bridgehead renderas="sect4">Required</bridgehead>
    <para role="required">
      <xref linkend="gtk3"/>
    </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"/> and
      <xref linkend="xmlto"/>
    </para>

    <bridgehead renderas="sect4">Required (runtime)</bridgehead>
    <para role="required">
      <xref role="runtime" linkend="notification-daemon"/> or
      <xref role="nodep" linkend="xfce4-notifyd"/>
    </para>

    <note>
      <para>
        <application>GNOME Shell</application> and <application>KDE KWin</application>
        provide their own notification daemons.
      </para>
    </note>

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

  <sect2 role="installation">
    <title>Installation of libnotify</title>

    <para>
      Install <application>libnotify</application> by running the following
      commands:
    </para>

<screen><userinput>mkdir build &amp;&amp;
cd    build &amp;&amp;

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

    <para>
      This package does not come with a test suite.
    </para>

    <para>
      Now, as the <systemitem class="username">root</systemitem> user:
    </para>

<screen role="root"><userinput>ninja install &amp;&amp;
mv -v /usr/share/doc/libnotify{,-&libnotify-version;}</userinput></screen>

  </sect2>

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

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

    <para>
      <parameter>-Dgtk_doc=false</parameter>: Remove this parameter if
      <application>GTK-Doc</application> is installed and you wish to rebuild
      and install the API documentation.
    </para>

  </sect2>

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

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

      <seglistitem>
        <seg>
          notify-send
        </seg>
        <seg>
          libnotify.so
        </seg>
        <seg>
         /usr/include/libnotify and
         /usr/share/gtk-doc/html/libnotify
        </seg>
      </seglistitem>
    </segmentedlist>

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

      <varlistentry id="notify-send">
        <term><command>notify-send</command></term>
        <listitem>
          <para>
            is a command used to send notifications
          </para>
          <indexterm zone="libnotify notify-send">
            <primary sortas="b-notify-send">notify-send</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="libnotify-lib">
        <term><filename class="libraryfile">libnotify.so</filename></term>
        <listitem>
          <para>
            contains the <application>libnotify</application> API functions
          </para>
          <indexterm zone="libnotify libnotify">
            <primary sortas="c-libnotify">libnotify.so</primary>
          </indexterm>
        </listitem>
      </varlistentry>

    </variablelist>

  </sect2>

</sect1>