source: x/lib/libnotify.xml@ 193af65

10.0 10.1 11.0 ken/refactor-virt lazarus qt5new trunk xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since 193af65 was 193af65, checked in by Ken Moffat <ken@…>, 14 months ago

Tags.

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@23556 af4574ff-66df-0310-9fd7-8a98e5e911e0

  • Property mode set to 100644
File size: 5.6 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 libnotify-download-http "&gnome-download-http;/libnotify/0.7/libnotify-&libnotify-version;.tar.xz">
8 <!ENTITY libnotify-download-ftp "&gnome-download-ftp;/libnotify/0.7/libnotify-&libnotify-version;.tar.xz">
9 <!ENTITY libnotify-md5sum "ccd9c53364174cc8d13e18a1988faa76">
10 <!ENTITY libnotify-size "96 KB">
11 <!ENTITY libnotify-buildsize "2.9 MB">
12 <!ENTITY libnotify-time "0.1 SBU">
13]>
14
15<sect1 id="libnotify" xreflabel="libnotify-&libnotify-version;">
16 <?dbhtml filename="libnotify.html"?>
17
18 <sect1info>
19 <othername>$LastChangedBy$</othername>
20 <date>$Date$</date>
21 </sect1info>
22
23 <title>libnotify-&libnotify-version;</title>
24
25 <indexterm zone="libnotify">
26 <primary sortas="a-libnotify">libnotify</primary>
27 </indexterm>
28
29 <sect2 role="package">
30 <title>Introduction to libnotify</title>
31
32 <para>
33 The <application>libnotify</application> library is used to send desktop
34 notifications to a notification daemon, as defined in the Desktop
35 Notifications spec. These notifications can be used to inform the user about
36 an event or display some form of information without getting in the user's
37 way.
38 </para>
39
40 &lfs10_checked;
41
42 <bridgehead renderas="sect3">Package Information</bridgehead>
43 <itemizedlist spacing="compact">
44 <listitem>
45 <para>
46 Download (HTTP): <ulink url="&libnotify-download-http;"/>
47 </para>
48 </listitem>
49 <listitem>
50 <para>
51 Download (FTP): <ulink url="&libnotify-download-ftp;"/>
52 </para>
53 </listitem>
54 <listitem>
55 <para>
56 Download MD5 sum: &libnotify-md5sum;
57 </para>
58 </listitem>
59 <listitem>
60 <para>
61 Download size: &libnotify-size;
62 </para>
63 </listitem>
64 <listitem>
65 <para>
66 Estimated disk space required: &libnotify-buildsize;
67 </para>
68 </listitem>
69 <listitem>
70 <para>
71 Estimated build time: &libnotify-time;
72 </para>
73 </listitem>
74 </itemizedlist>
75
76 <bridgehead renderas="sect3">libnotify Dependencies</bridgehead>
77
78 <bridgehead renderas="sect4">Required</bridgehead>
79 <para role="required">
80 <xref linkend="gtk3"/>
81 </para>
82
83 <bridgehead renderas="sect4">Optional (Required if building GNOME)</bridgehead>
84 <para role="optional">
85 <xref linkend="gobject-introspection"/>
86 </para>
87
88 <bridgehead renderas="sect4">Optional</bridgehead>
89 <para role="optional">
90 <xref linkend="gtk-doc"/> and
91 <xref linkend="xmlto"/>
92 </para>
93
94 <bridgehead renderas="sect4">Required (runtime)</bridgehead>
95 <para role="required">
96 <xref role="runtime" linkend="notification-daemon"/> or
97 <xref role="nodep" linkend="xfce4-notifyd"/>
98 </para>
99
100 <note>
101 <para>
102 <application>GNOME Shell</application> and <application>KDE KWin</application>
103 provide their own notification daemons.
104 </para>
105 </note>
106
107 <para condition="html" role="usernotes">User Notes:
108 <ulink url="&blfs-wiki;/libnotify"/>
109 </para>
110 </sect2>
111
112 <sect2 role="installation">
113 <title>Installation of libnotify</title>
114
115 <para>
116 Install <application>libnotify</application> by running the following
117 commands:
118 </para>
119
120<screen><userinput>mkdir build &amp;&amp;
121cd build &amp;&amp;
122
123meson --prefix=/usr -Dgtk_doc=false -Dman=false .. &amp;&amp;
124ninja</userinput></screen>
125
126 <para>
127 This package does not come with a test suite.
128 </para>
129
130 <para>
131 Now, as the <systemitem class="username">root</systemitem> user:
132 </para>
133
134<screen role="root"><userinput>ninja install</userinput></screen>
135
136 </sect2>
137
138 <sect2 role="commands">
139 <title>Command Explanations</title>
140
141 <para>
142 <parameter>-Dgtk_doc=false</parameter>: Remove this parameter if
143 <application>GTK-Doc</application> is installed and you wish to rebuild
144 and install the API documentation.
145 </para>
146
147 </sect2>
148
149 <sect2 role="content">
150 <title>Contents</title>
151
152 <segmentedlist>
153 <segtitle>Installed Program</segtitle>
154 <segtitle>Installed Library</segtitle>
155 <segtitle>Installed Directories</segtitle>
156
157 <seglistitem>
158 <seg>
159 notify-send
160 </seg>
161 <seg>
162 libnotify.so
163 </seg>
164 <seg>
165 /usr/include/libnotify and
166 /usr/share/gtk-doc/html/libnotify
167 </seg>
168 </seglistitem>
169 </segmentedlist>
170
171 <variablelist>
172 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
173 <?dbfo list-presentation="list"?>
174 <?dbhtml list-presentation="table"?>
175
176 <varlistentry id="notify-send">
177 <term><command>notify-send</command></term>
178 <listitem>
179 <para>
180 is a command used to send notifications.
181 </para>
182 <indexterm zone="libnotify notify-send">
183 <primary sortas="b-notify-send">notify-send</primary>
184 </indexterm>
185 </listitem>
186 </varlistentry>
187
188 <varlistentry id="libnotify-lib">
189 <term><filename class='libraryfile'>libnotify.so</filename></term>
190 <listitem>
191 <para>
192 contains the <application>libnotify</application> API functions.
193 </para>
194 <indexterm zone="libnotify libnotify">
195 <primary sortas="c-libnotify">libnotify.so</primary>
196 </indexterm>
197 </listitem>
198 </varlistentry>
199
200 </variablelist>
201
202 </sect2>
203
204</sect1>
Note: See TracBrowser for help on using the repository browser.