jcarr
/
libnotify
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Compare commits

base: jcarr:master
Branches Tags
jcarr:master
jcarr:jcarr
jcarr:revert-e35921f1
jcarr:wip/fmuellner/fix-meson-build
jcarr:abderrahim/fix-pkg-config
jcarr:0.5
jcarr:pre-0.3.0
jcarr:0.8.1
jcarr:0.8.0
jcarr:0.7.12
jcarr:0.7.11
jcarr:0.7.10
jcarr:0.7.9
jcarr:0.7.8
jcarr:0.7.7
jcarr:0.7.6
jcarr:0.7.5
jcarr:0.7.4
jcarr:0.7.2
jcarr:0.7.1
jcarr:0.7.0
jcarr:0.5.2
jcarr:0.6.0
jcarr:0.5.1
jcarr:0.5.0
jcarr:0.4.5
jcarr:0.4.4
jcarr:0.4.3
jcarr:0.4.2
jcarr:0.4.1
jcarr:0.3.2
jcarr:0.3.0
jcarr:0.3.0@2371
jcarr:0.2.2
..
compare: jcarr:0.5
Branches Tags
jcarr:jcarr
jcarr:master
jcarr:revert-e35921f1
jcarr:wip/fmuellner/fix-meson-build
jcarr:abderrahim/fix-pkg-config
jcarr:0.5
jcarr:pre-0.3.0
jcarr:0.8.1
jcarr:0.8.0
jcarr:0.7.12
jcarr:0.7.11
jcarr:0.7.10
jcarr:0.7.9
jcarr:0.7.8
jcarr:0.7.7
jcarr:0.7.6
jcarr:0.7.5
jcarr:0.7.4
jcarr:0.7.2
jcarr:0.7.1
jcarr:0.7.0
jcarr:0.5.2
jcarr:0.6.0
jcarr:0.5.1
jcarr:0.5.0
jcarr:0.4.5
jcarr:0.4.4
jcarr:0.4.3
jcarr:0.4.2
jcarr:0.4.1
jcarr:0.3.2
jcarr:0.3.0
jcarr:0.3.0@2371
jcarr:0.2.2

7 Commits
master ... 0.5

Author SHA1 Message Date
William Jon McCann 061bff0fd8 Include the current headers first 2010-10-14 23:30:58 -04:00
William Jon McCann 7748d2bfd5 Update for release 2010-10-14 23:23:36 -04:00
William Jon McCann dc66508e2e Use notify-features.h instead of features.h 2010-10-14 23:15:55 -04:00
William Jon McCann 2d9ba81998 Add a macro for determining the version of the library 2010-10-14 23:15:43 -04:00
Jonny Lamb efeeee9269 Use correct variable in NULL check 
If you pass NULL as the fourth argument to notify_get_server_info it
segfaults.

https://bugzilla.gnome.org/show_bug.cgi?id=623096
(cherry picked from commit 4830863bab)
 2010-07-01 20:48:35 -04:00
William Jon McCann b98b25a985 Skip version 0.5.1 since it was a release done from the wrong branch 2010-07-01 20:40:46 -04:00
Martin Pitt 13d2876bb0 Fix assertion when uniniting without any notifications 
The lazy initialization from commit 3dc04fa caused a small regression: When a
process would init and uninit libnotify without ever sending a notification,
_proxy was still NULL, which caused an assertion

(process:20953): GLib-GObject-CRITICAL **: g_object_unref: assertion `G_IS_OBJECT (object)' failed

Bug-Ubuntu: https://bugs.launchpad.net/bugs/570462
(cherry picked from commit 1a103f1eee)
 2010-07-01 20:38:06 -04:00
69 changed files with 3490 additions and 3245 deletions
Show Stats Expand all files Collapse all files

37
.gitlab-ci.yml
View File

@ -1,37 +0,0 @@
variables:
DEBIAN_FRONTEND: noninteractive
stages:
- build
build:ubuntu:
stage: build
image: ubuntu:devel
before_script:
- apt-get update &&
- apt-get install -q -y --no-install-recommends
gobject-introspection
gtk-doc-tools
libgdk-pixbuf2.0-dev
libgirepository1.0-dev
libglib2.0-dev
libgtk-3-dev
libpopt-dev
xmlto
ninja-build
python3-pip
python3-setuptools
xsltproc
docbook-xsl-ns
- pip3 install meson
script:
- meson _build -Ddocbook_docs=enabled
- ninja -C _build install
artifacts:
expose_as: "Build artifacts"
paths:
- _build/docs/notification-spec.html
- _build/docs/reference/html
- _build/docs/reference/html/index.html
- _build/meson-logs

984
ChangeLog Normal file
View File

@ -0,0 +1,984 @@
Sun Jun 14 14:50:00 UTC 2009 Andre Klapper <a9016009@gmx.de>
* libnotify/notification.c:
- Remove deprecated GLib symbols.
========================= 0.4.5 =========================
Thu Nov 20 03:16:53 PST 2008 Christian Hammond <chipx86@chipx86.com>
* docs/reference/tmpl/notification.sgml:
* ChangeLog:
* configure.ac:
* NEWS:
- Bump to version 0.4.5.
Thu Sep 25 18:45:41 PDT 2008 Christian Hammond <chipx86@chipx86.com>
* libnotify/notification.c:
* libnotify/notification.h:
- Prevent a backwards-compatibility breakage introduced where the
"reason" code was added to the "closed" signal. This meant that
existing signal handlers that passed extra data would break. We now
require that you call notify_notification_get_closed_reason() to get
this data.
Thu Sep 25 18:05:38 PDT 2008 Christian Hammond <chipx86@chipx86.com>
* libnotify/notification.h:
* NEWS:
- Fixed a breakage where we were including gtkversion.h directly.
Reported by Richard Hughes.
Tue Mar 18 21:51:32 PDT 2008 Christian Hammond <chipx86@chipx86.com>
* libnotify/notification.c:
* libnotify/notification.h:
* libnotify/notify.c:
* libnotify/notify-marshal.list:
* NEWS:
- Add support for sending the closed reason in the signal handler.
Closes ticket #139.
Sat Aug 25 18:08:01 PDT 2007 Christian Hammond <chipx86@chipx86.com>
* tools/notify-send.c:
- Relicense notify-send under the LGPL in order to keep licensing
simple and to allow reuse in more projects. Fixes bug #124.
Sun Apr 29 02:45:20 PDT 2007 Christian Hammond <chipx86@chipx86.com>
* configure.ac:
- Bump to version 0.4.4.90.
Sun Apr 29 00:39:32 PDT 2007 Christian Hammond <chipx86@chipx86.com>
* docs/reference/tmpl/notification.sgml:
* libnotify/notification.c:
- Patch by Lucas Rocha to add GObject property accessors for
notification IDs.
========================= 0.4.4 =========================
Tue Feb 27 21:11:36 PST 2007 Christian Hammond <chipx86@chipx86.com>
* NEWS:
* configure.ac:
- Bump to version 0.4.4.
Thu Feb 15 03:10:39 PST 2007 Christian Hammond <chipx86@chipx86.com>
* NEWS:
- Update with all the fixes in this release.
Thu Feb 15 02:44:16 PST 2007 Christian Hammond <chipx86@chipx86.com>
* libnotify/notification.c:
- Prevent a crash when the handler for a notification's closed signal
removes the last reference to the notification. We attempted to set
the ID of the notification after emitting this signal, but the
notification was destroyed already. So, keep a reference while doing
all this. This fixes bug #116.
Thu Feb 15 02:29:01 PST 2007 Christian Hammond <chipx86@chipx86.com>
* libnotify/notify.c:
- Get rid of format_func.
Thu Feb 15 02:06:11 PST 2007 Christian Hammond <chipx86@chipx86.com>
* libnotify/notification.c:
- Fix some memory leaks when appending data to a message. Scary,
horrible, traumatizing memory leaks. Actually it's pretty bad,
though, so new release coming up soon. This fixes bug #112.
Thu Feb 15 01:58:52 PST 2007 Christian Hammond <chipx86@chipx86.com>
* tests/test-image.c:
- Use a more common (I hope) icontheme icon for the test.
Thu Feb 15 00:52:56 PST 2007 Christian Hammond <chipx86@chipx86.com>
* libnotify/notification.c:
- Fix a bug in notify_notification_add_action where the function
to free the user data was never called, causing memory leaks.
This fixes bug #119.
Mon Nov 13 23:42:07 PST 2006 Christian Hammond <chipx86@chipx86.com>
* tests/Makefile.am:
A tests/test-size-changes.c:
* tests/test-default-action.c:
- Added a test program that displays three notifications and then
changes the amount of text in one of them.
Sun Nov 05 12:06:01 PST 2006 Christian Hammond <chipx86@chipx86.com>
* libnotify/notify.c:
- Patch by Giacomo Lozito to fix a problem where the dbus proxy was
not being freed on notify_uninit, which led to problems when libnotify
was used in a loadable module. This fixes bug #92.
Sun Nov 05 11:54:10 PST 2006 Christian Hammond <chipx86@chipx86.com>
* configure.ac:
* NEWS:
- Bump to version 0.4.3.90.
Sun Nov 05 11:50:44 PST 2006 Christian Hammond <chipx86@chipx86.com>
* libnotify/notification.c:
- Patch by jylefort to only reset a notification's ID to 0 if it
was the notification closed. This fixes bug #94.
========================= 0.4.3 =========================
Sun Oct 08 13:21:20 EDT 2006 Christian Hammond <chipx86@chipx86.com>
* configure.ac:
* NEWS:
- Bump the version to 0.4.3.
- Add the release datestamp.
Sun Sep 03 23:48:29 PDT 2006 Christian Hammond <chipx86@chipx86.com>
* libnotify/notification.c:
* NEWS:
- Patch by lucasr to fix an invalid assertion in
notify_notification_new_with_status_icon. This closes bug #85.
Sun Sep 03 23:44:01 PDT 2006 Christian Hammond <chipx86@chipx86.com>
* libnotify/notify.c:
* NEWS:
- Patch by berndth to stop using g_atexit, as this can fail in the
case of a dynamically loaded module. Applications should now call
notify_uninit() on exit or on plugin unload. This closes bug #86.
Mon Jul 31 19:40:10 PDT 2006 Christian Hammond <chipx86@chipx86.com>
* libnotify/notification.c:
- Emit the property change notification for "status-icon" and not
"attach-icon". This closes bug #81.
Sat Jul 29 03:02:18 PDT 2006 Christian Hammond <chipx86@chipx86.com>
* libnotify/notification.c:
- Patch by Ed Catmur to reset a notification's ID if
notify_notification_show() is called on a notification that had
already been closed. This causes the notification to receive a new
ID. This closes ticket #78.
Thu Jul 13 00:44:29 PDT 2006 Christian Hammond <chipx86@chipx86.com>
* configure.ac:
- Patch by compnerd to check for glib 2.6+ during configure, as that
is now required. This closes ticket #69.
Thu Jul 13 00:41:16 PDT 2006 Christian Hammond <chipx86@chipx86.com>
* libnotify/notification.c:
* AUTHORS:
* configure.ac:
- Patch by mderezynski to send an array of UCHARs as expected by
notification-daemon rather than an array of CHARs. This closes
ticket #68.
- Bump to version 0.4.2.90.
========================= 0.4.2 =========================
Sat Jun 17 19:17:05 PDT 2006 Christian Hammond <chipx86@chipx86.com>
* libnotify/internal.h:
* libnotify/notify.h:
* configure.ac:
- Add G_BEGIN_DECLS and G_END_DECLS to notify.h, so that libnotify can
be used in C++ applications properly.
- Bump to version 0.4.2.
========================= 0.4.1 =========================
Sat Jun 17 18:17:28 PDT 2006 Christian Hammond <chipx86@chipx86.com>
* Makefile.am:
* NEWS:
D libnotify.spec.in:
* configure.ac:
- Fix make distcheck and remove the old RPM spec file.
- Update the news.
- Bump the version to 0.4.1.
Thu Jun 15 02:14:14 PDT 2006 Christian Hammond <chipx86@chipx86.com>
* libnotify/notification.c:
- Fix a build error on gtk 2.9.2+. This fixes bug #65.
Tue Jun 06 12:44:48 PDT 2006 Christian Hammond <chipx86@chipx86.com>
* docs/reference/tmpl/notification.sgml:
* libnotify/notification.h:
- Small random fixes.
Tue Jun 06 01:45:46 PDT 2006 Christian Hammond <chipx86@chipx86.com>
* docs/reference/libnotify-docs.sgml:
* docs/reference/tmpl/libnotify-docs.sgml:
- Fix up some references to files.
Tue Jun 06 01:29:20 PDT 2006 Christian Hammond <chipx86@chipx86.com>
* docs/reference/libnotify-sections.txt:
* docs/reference/tmpl/notification.sgml:
* docs/reference/tmpl/notify.sgml:
* libnotify/notification.c:
* libnotify/notification.h:
- Provide more documentation.
Tue Jun 06 00:27:50 PDT 2006 Christian Hammond <chipx86@chipx86.com>
* docs/reference/tmpl/notification.sgml:
* libnotify/notification.c:
* libnotify/notification.h:
- Update notify_notification_set_geometry_hints() to take a x, y
instead of a GdkRectangle. We don't need the width and height
information.
Tue Jun 06 00:14:00 PDT 2006 Christian Hammond <chipx86@chipx86.com>
A docs/reference/libnotify-docs.sgml:
A docs/reference/libnotify-overrides.txt:
A docs/reference/libnotify-sections.txt:
A docs/reference/tmpl:
A docs/reference/tmpl/libnotify-docs.sgml:
A docs/reference/tmpl/libnotify-unused.sgml:
A docs/reference/tmpl/notification.sgml:
A docs/reference/tmpl/notify.sgml:
A docs/reference/Makefile.am:
A docs/Makefile.am:
* libnotify/notification.c:
* libnotify/notification.h:
* libnotify/notify.c:
D Doxyfile.in:
* Makefile.am:
* autogen.sh:
* configure.ac:
- Add some gtk-doc documentation.
Sun Jun 04 17:44:27 PDT 2006 Christian Hammond <chipx86@chipx86.com>
* libnotify/notification.c:
* libnotify/notification.h:
- Patch by chpe to add support for using the new GtkStatusIcon in
GTK+ 2.9.x. These functions are #ifdef'd to only be provided in
supported versions of GTK. The patch also added support for GObject
properties on the NotifyNotification objects. This closes ticket #60.
Sun Jun 04 16:12:05 PDT 2006 Christian Hammond <chipx86@chipx86.com>
* libnotify/notify.c:
- Set _initted to FALSE in notify_uninit(), so that notify_is_initted()
won't return TRUE.
Fri Jun 02 15:56:05 PDT 2006 Christian Hammond <chipx86@chipx86.com>
* AUTHORS:
* configure.ac:
* libnotify.pc.in:
- Improve libnotify.pc by pushing dependencies into Requires: instead of
Cflags: and Libs:. This closes ticket #58.
- Bump the version to 0.4.0.90.
========================= 0.4.0 =========================
Wed Apr 26 01:15:20 PDT 2006 Christian Hammond <chipx86@chipx86.com>
* tests/Makefile.am:
- Bundle applet-critical.png.
Wed Apr 26 01:07:34 PDT 2006 Christian Hammond <chipx86@chipx86.com>
* tests/test-replace.c:
- Set the second, replaced notification to have a default expiration.
Tue Apr 25 23:52:42 PDT 2006 Christian Hammond <chipx86@chipx86.com>
* libnotify/Makefile.am:
* libnotify/notify.h:
* NEWS:
* configure.ac:
- Add GTypes for the enums.
- Bump to version 0.4.0.
Fri Apr 21 15:35:40 PDT 2006 Christian Hammond <chipx86@chipx86.com>
* tools/notify-send.c:
- Use fprintf instead of g_warning.
Fri Apr 21 14:38:04 PDT 2006 Christian Hammond <chipx86@chipx86.com>
* AUTHORS:
- Add some names to the patch writers list.
Fri Apr 21 14:35:30 PDT 2006 Christian Hammond <chipx86@chipx86.com>
* tests/test-server-info.c:
* NEWS:
- Patch by jensgr to fix some C99 usage in the tests code.
Fri Apr 21 14:21:47 PDT 2006 Christian Hammond <chipx86@chipx86.com>
* tools/Makefile.am:
* tools/notify-send.c:
* NEWS:
* configure.ac:
- Patch by M.S. to switch notify-send to use GOption instead of popt,
to add -v, --version, -h, and --hint options, and to rename
-T, --type to -c, --category. This also fixes assertions when calling
notify-send "". This closes ticket #41.
Mon Mar 20 14:12:15 PST 2006 Christian Hammond <chipx86@chipx86.com>
* tools/notify-send.c:
- Change the help for notify-send to indicate that --expire-timeout
requires milliseconds, not seconds. This fixes bug #28.
- Fixed the short flag for --type to be -T. This fixes bug #18.
Sat Mar 18 14:47:53 PST 2006 Christian Hammond <chipx86@chipx86.com>
* tools/notify-send.c:
- Fix notify-send on PPC.
Sat Feb 04 17:18:38 PST 2006 Christian Hammond <chipx86@chipx86.com>
* libnotify/notification.c:
- Don't complain about an unknown action when the action is "default"
Sat Feb 04 13:29:22 PST 2006 Christian Hammond <chipx86@chipx86.com>
A tests/test-xy-actions.c:
* tests/Makefile.am:
- Add test-xy-actions.
Sat Feb 04 12:41:03 PST 2006 Christian Hammond <chipx86@chipx86.com>
* tests/test-multi-actions.c:
- Running out of disk space is a critical notification. Set the
urgency level in test-multi-actions.
Sat Feb 04 02:04:13 PST 2006 Christian Hammond <chipx86@chipx86.com>
* tests/test-urgency.c:
- It's a good thing to actually set the urgency levels in the
urgency test.
Sat Feb 04 01:47:00 PST 2006 Christian Hammond <chipx86@chipx86.com>
A tests/test-urgency.c:
* tests/Makefile.am:
- Add a test-urgency testcase.
Sun Jan 29 13:26:31 PST 2006 Christian Hammond <chipx86@chipx86.com>
* Doxyfile.in:
* libnotify/notification.c:
* libnotify/notification.h:
- More Doxygen happiness. Still no NotifyNotification docs yet though.
Sun Jan 29 13:17:43 PST 2006 Christian Hammond <chipx86@chipx86.com>
* libnotify/notify.h:
- Make Doxygen happy.
========================= 0.3.2 =========================
Mon Jan 23 01:31:59 PST 2006 Christian Hammond <chipx86@chipx86.com>
* libnotify/notification.h:
- Removed notify_notification_{ref,unref} from notification.h.
Mon Jan 23 01:30:45 PST 2006 Christian Hammond <chipx86@chipx86.com>
* libnotify/Makefile.am:
- Make distcheck happy.
Mon Jan 23 01:20:36 PST 2006 Christian Hammond <chipx86@chipx86.com>
* docs/ChangeLog:
* NEWS:
* configure.ac:
- Bumped the version to 0.3.2.
- Added news.
Mon Jan 23 01:10:23 PST 2006 Christian Hammond <chipx86@chipx86.com>
* libnotify/internal.h:
* libnotify/notification.c:
* libnotify/notify.c:
* tests/test-replace-widget.c:
- Make a best attempt at clearing away notifications that require
actions or that exist until clicked when the calling application
exits. This doesn't always work.
Sun Jan 22 23:46:27 PST 2006 Christian Hammond <chipx86@chipx86.com>
* docs/notification-spec.xml:
- Fix some errors in the spec file. Some pieces were not updated when
the specification was changed, and some pieces were invalid XML.
Sun Jan 22 13:21:52 PST 2006 Christian Hammond <chipx86@chipx86.com>
* libnotify/notification.c:
- Raw images are broken in D-BUS versions less than 0.60. Don't crash
under this case, and warn the user.
Sat Jan 21 00:37:03 PST 2006 Christian Hammond <chipx86@chipx86.com>
* libnotify/internal.h:
* libnotify/notification.c:
* libnotify/notify.c:
* tests/test-image.c:
- Use one D-BUS connection, one GProxy, total. This is better than the
one per notification, and fixes a few bugs.
Fri Jan 20 20:49:31 PST 2006 Christian Hammond <chipx86@chipx86.com>
* libnotify/notify.c:
- Some small code cleanups.
Fri Jan 20 02:19:29 PST 2006 Christian Hammond <chipx86@chipx86.com>
* libnotify/notification.c:
* libnotify/notification.h:
* tests/test-basic.c:
* tools/notify-send.c:
- Remove notify_notification_show_and_forget(). It's less confusing to
have one show function, and require that the user unref. It also
simplifies the code quite a bit.
Fri Jan 20 02:10:50 PST 2006 Christian Hammond <chipx86@chipx86.com>
* libnotify/notification.c:
* libnotify/notification.h:
* tests/test-default-action.c:
* tests/test-multi-actions.c:
- Implement per-action user data.
Fri Jan 20 01:59:26 PST 2006 Christian Hammond <chipx86@chipx86.com>
* docs/notification-spec.xml:
* libnotify/notification.c:
* libnotify/notification.h:
* tests/test-default-action.c:
* tests/test-image.c:
* tests/test-multi-actions.c:
* tools/notify-send.c:
- Fix some weird argument ordering in the calls to
dbus_g_proxy_call_*().
- Re-order the arguments as per the spec.
- Change NOTIFY_TIMEOUT_* to NOTIFY_EXPIRES_*.
- Update the spec to 0.9.
Fri Jan 20 01:37:42 PST 2006 Christian Hammond <chipx86@chipx86.com>
* libnotify/notification.c:
* libnotify/notification.h:
* libnotify/notify.c:
- Clean up a lot of the API. Several functions returned gboolean when
there was very little point in doing so.
- Add assertions to all the functions.
- Remove the notify_notification_{set,get}_user_data() functions. These
are useless, since this is a GObject, and we get it for free.
Thu Jan 19 22:07:41 PST 2006 Christian Hammond <chipx86@chipx86.com>
A libnotify/internal.h:
A libnotify/notification.c:
A libnotify/notification.h:
D libnotify/notifycommon.h:
D libnotify/notifynotification.c:
D libnotify/notifynotification.h:
* libnotify/Makefile.am:
* libnotify/notify.c:
* libnotify/notify.h:
- Do some rearranging of the files in libnotify, and include things
properly so people can actually use the library without fudging with
include paths.
Thu Jan 19 21:56:29 PST 2006 Christian Hammond <chipx86@chipx86.com>
* libnotify/Makefile.am:
D libnotify/dbus-compat.h:
* libnotify/notify.c:
- Get rid of dbus-compat.h.
Thu Jan 19 21:55:08 PST 2006 Christian Hammond <chipx86@chipx86.com>
* libnotify/dbus-compat.h:
* libnotify/notify.c:
* libnotify/notifycommon.h:
* libnotify/notify.h:
* libnotify/notifynotification.c:
* libnotify/notifynotification.h:
- Fixed the coding style.
Thu Jan 19 01:34:57 PST 2006 Christian Hammond <chipx86@chipx86.com>
* tools/notify-send.c:
- Make notify-send work again when a body isn't specified.
Wed Jan 18 22:24:10 PST 2006 Christian Hammond <chipx86@chipx86.com>
* libnotify/notifynotification.h:
* tests/test-xy-stress.c:
- Remove the config.h include from notifynotification.h.
Sun Jan 15 17:52:39 PST 2006 Christian Hammond <chipx86@chipx86.com>
* docs/notification-spec.xml:
* libnotify/notify.c:
* libnotify/notify.h:
* libnotify/notifynotification.c:
* tests/Makefile.am:
A tests/test-server-info.c:
* tests/test-xy.c:
- Add back notify_get_server_info() and notify_get_server_caps().
Thu Jan 12 2006 John (J5) Palmieri <johnp@redhat.com>
* libnotify/notifynotification.c (notify_notification_set_user_data):
fix free function addition
(notify_notification_get_user_data): added method for actually
getting the user data (fd.o bug# 5418)
- patches provided by Duarte Henriques
<duarte.henriques at gmail dot com>
Tue Jan 10 23:33:47 PST 2006 Christian Hammond <chipx86@chipx86.com>
* configure.ac:
- Require D-BUS 0.36+.
Tue Jan 10 22:55:35 PST 2006 Christian Hammond <chipx86@chipx86.com>
* tests/test-default-action.c:
* tools/notify-send.c:
- Fix some C99 usage.
Tue Jan 10 16:20:27 MST 2006 David Trowbridge <trowbrds@gmail.com>
* libnotify/Makefile.am:
- Make sure marshal files actually get built
Mon Jan 09 11:13:15 PST 2006 Christian Hammond <chipx86@chipx86.com>
* libnotify/Makefile.am:
* libnotify/Makefile.in:
A libnotify/notify-marshal.list:
D libnotify/notifymarshal.c:
D libnotify/notifymarshal.h:
* libnotify/notifynotification.c:
* configure.ac:
- Generate the marshal files automatically. We shouldn't be doing it
by hand.
Mon Jan 09 10:15:57 PST 2006 Christian Hammond <chipx86@chipx86.com>
* libnotify/Makefile.in:
* libnotify/notify.c:
* libnotify/notifynotification.c:
* tests/test-default-action.c:
* tests/test-image.c:
* tests/test-multi-actions.c:
* tests/test-replace-widget.c:
* tests/test-xy-stress.c:
- Clean up lots of warnings.
========================= 0.3.0 =========================
Tue Dec 13 2005 John (J5) Palmieri <johnp@redhat.com>
* Release 0.3.0
* tests/Makefile.am, tools/Makefile.am: patch from Rodney
Dawes <dobey at novell.com> fixing make distcheck
* tools/notify-send.c: use show_and_forget
Fri Dec 09 2005 John (J5) Palmieri <johnp@redhat.com>
* libnotify/notifymarshal.[c|h]: new files where GLib callback
marshalers are added
* libnotify/notifynotification.c (notify_notifiaction_init): Add a
marshaller for signals with uint, string parameters
(_gslist_to_string_array): new internal method that coverts
a GSList to a NULL terminated array of strings
(_notify_notification_show_internal): send the actions list as an
array of strings, not a GSList which does not work with the bindings
* libnotify/Makefile.am: notifymarshal.[c|h] added
* tests/test-multi-actions.c: working example of using actions
Fri Dec 02 2005 John (J5) Palmieri <johnp@redhat.com>
* libnotify/notifynotification.c (notify_notification_add_action):
implement adding actions
(_action_signal_handler): handle actions coming from the server
(notify_notifcation_clear_actions): new method for clearning out
the actions list and hash
Fri Dec 02 2005 John (J5) Palmieri <johnp@redhat.com>
* libnotify/notifynotification.c (notify_notification_show_and_forget):
new method that shows and then unrefs the NotifyNotification object.
use this if you just want to fire off a quick notification.
* various compiler warning cleanups
Fri Dec 02 2005 John (J5) Palmieri <johnp@redhat.com>
* libnotify/notifynotification.c (SIGNAL_TYPE_CLOSED): "closed" glib
signal added
(notify_notification_clear_hints): New API for clearing out the
hints hash
(notify_notification_ref, notify_notification_unref): removed - use
g_object_ref/unref
* tests/*: Various changes to the test binaries
Thu Nov 10 14:00:00 EST 2005 John (J5) Palmieri <johnp@redhat.com>
* Complete rewrite and first import to libnotify-ng module in SVN
Mon Jul 04 02:13:56 PDT 2005 Christian Hammond <chipx86@chipx86.com>
* tests/Makefile.am:
* tests/test-markup.c:
A tests/test-xy-stress.c:
* configure.ac:
- Conditionally build gdk-dependent test apps if we have gdk.
- Added a X, Y stress test that will be used to help test
accurately positioning the arrows.
Thu Jun 30 21:09:18 PDT 2005 Christian Hammond <chipx86@chipx86.com>
* tests/Makefile.am:
- Don't install the test programs during make install.
Thu Jun 30 21:03:30 PDT 2005 Christian Hammond <chipx86@chipx86.com>
* libnotify/notify.c:
* libnotify/notify.h:
* tests/test-animation.c:
* tests/test-basic.c:
* tests/test-default-action.c:
* tests/test-error.c:
* tests/test-image.c:
* tests/test-markup.c:
* tests/test-multi-actions.c:
* tests/test-replace.c:
* tools/notify-send.c:
- Added support for hints in the API.
Mon Jun 20 06:13:02 PDT 2005 Christian Hammond <chipx86@gnupdate.org>
* libnotify/notify.c:
- Be a little better at not crashing. Just a bit better. There's
still another crash I'm trying to track down.
Mon Jun 20 04:53:29 PDT 2005 Christian Hammond <chipx86@gnupdate.org>
* libnotify/notify.c:
- Close the right container in D-BUS 0.3x.
Mon Jun 20 02:49:27 PDT 2005 Christian Hammond <chipx86@gnupdate.org>
* libnotify/Makefile.am:
A libnotify/dbus-compat.h:
- Add dbus-compat.h.
Mon Jun 20 02:43:26 PDT 2005 Christian Hammond <chipx86@gnupdate.org>
* libnotify/notify.c:
* configure.ac:
- Add support for compiling under D-BUS 0.3x. Actually running
has not yet been tested!
Fri Apr 01 09:21:26 PST 2005 Christian Hammond <chipx86@gnupdate.org>
* libnotify/notify.c:
- Updated to work with 0.6 of the notification spec.
Sat Nov 06 15:40:48 PST 2004 Christian Hammond <chipx86@gnupdate.org>
* libnotify/notify.h:
- Move our TODO list to the Doxygen @todo commands, so we'll get it
in a nice little page of its own in the API docs.
Sat Nov 06 15:35:52 PST 2004 Christian Hammond <chipx86@gnupdate.org>
* libnotify/notify.h:
- Move the emacs mode string out of the Doxygen comment and into its
own.
Sat Nov 06 15:11:53 PST 2004 Christian Hammond <chipx86@gnupdate.org>
* libnotify/notify.h:
A Doxyfile.in:
* Makefile.am:
* configure.ac:
- Add a Doxyfile.in and update things so we can get doxygen
docs.
Wed Nov 03 23:39:23 PST 2004 Christian Hammond <chipx86@gnupdate.org>
* libnotify/notify.c:
- Use glib's memory allocation stuff instead of libc's.
Wed Nov 03 23:34:10 PST 2004 Christian Hammond <chipx86@gnupdate.org>
* libnotify/notify.c:
* libnotify/notify.h:
* tests/test-animation.c:
* tests/test-image.c:
- Patch from Mike Hearn to do a bunch of stuff, like handling icons
and animations better.
Wed Nov 03 01:19:42 PST 2004 Christian Hammond <chipx86@gnupdate.org>
* configure.ac:
A libnotify.spec.in:
- Fix make distcheck.
Wed Sep 29 22:34:03 PDT 2004 Christian Hammond <chipx86@gnupdate.org>
* libnotify/notify.c:
* tools/notify-send.c:
- Don't flush the D-BUS connection, and make sure we disconnect from it.
Wed Sep 29 21:53:15 PDT 2004 Christian Hammond <chipx86@gnupdate.org>
* libnotify/notify.c:
* libnotify/notify.h:
* tests/test-animation.c:
* tests/test-basic.c:
* tests/test-default-action.c:
* tests/test-error.c:
* tests/test-image.c:
* tests/test-markup.c:
* tests/test-multi-actions.c:
* tests/test-replace.c:
* tools/notify-send.c:
- Updated to match the spec.
Sat Sep 25 12:59:26 PDT 2004 Christian Hammond <chipx86@gnupdate.org>
* libnotify/notify.c:
* tests/test-animation.c:
* tests/test-default-action.c:
- Fixed to compile.
Wed Sep 01 00:39:23 PDT 2004 Christian Hammond <chipx86@gnupdate.org>
* docs/ChangeLog:
* SPECIFICATION:
- Moved specification documentation.
- Moved specification ChangeLog.
Wed Sep 01 00:30:53 PDT 2004 Christian Hammond <chipx86@gnupdate.org>
* docs/notification-spec.xml:
- Finishing adding the rest of the signals to the spec.
Sun Aug 29 22:27:42 PDT 2004 Christian Hammond <chipx86@gnupdate.org>
A docs/notification-spec.ps:
A docs/notification-spec.xml:
- Added the notification spec in docbook format. It's not finished.
I'm just tired of working on it.
Wed Jul 14 02:11:48 GMT 2004 Mike Hearn <mike@navi.cx>
* libnotify/notify.c: Use pointers instead of GINT_TO_POINTER
* tools/test-replace.c: Test replacing notifications
Tue Jul 13 23:58:54 GMT 2004 Mike Hearn <mike@navi.cx>
* SPECIFICATION: CloseNotification sends NotificationClosed signal.
Mon Jul 5 00:12:03 GMT 2004 Mike Hearn <mike@navi.cx>
* tools/notify-send.c (main): Treat expiry times < current time
as timeouts from current instant
Sun Jul 4 22:54:44 GMT 2004 Mike Hearn <mike@navi.cx>
* libnotify/notify.c: Use a direct hash rather than an int hash
Sun Jul 04 14:32:46 PDT 2004 Christian Hammond <chipx86@gnupdate.org>
* libnotify/notify.c:
- Don't make IDs of 0 bad. They just want to be loved, too.
Sun Jul 04 14:08:59 PDT 2004 Christian Hammond <chipx86@gnupdate.org>
* libnotify/notify.c:
* libnotify/notify.h:
* tools/notify-send.c:
* SPECIFICATION:
- Changed timeouts to expire times.
- Install notify-send.
Sun Jul 04 13:46:32 PDT 2004 Christian Hammond <chipx86@gnupdate.org>
* tools/notify-send.c:
- Don't initialize the library until we're ready to talk to it.
Sun Jul 04 13:34:14 PDT 2004 Christian Hammond <chipx86@gnupdate.org>
* libnotify/notify.c:
* SPECIFICATION:
- Added the urgency level to the spec, and made it a byte.
Sun Jul 04 13:28:51 PDT 2004 Christian Hammond <chipx86@gnupdate.org>
A tools/:
R tests/:
* Makefile.am:
* configure.ac:
- Renamed tests to tools.
Sun Jul 04 13:28:00 PDT 2004 Christian Hammond <chipx86@gnupdate.org>
* tests/Makefile.am:
A tests/notify-send.c:
- Added the notify-send tool.
Sat Jul 03 12:35:35 PDT 2004 Christian Hammond <chipx86@gnupdate.org>
* libnotify/notify.c:
* libnotify/notify.h:
- Added support for GetCapabilities.
Sat Jul 03 12:27:58 PDT 2004 Christian Hammond <chipx86@gnupdate.org>
* libnotify/notify.c:
* libnotify/notify.h:
- Add support for GetServerInformation.
Sat Jul 03 12:21:05 PDT 2004 Christian Hammond <chipx86@gnupdate.org>
* libnotify/notify.c:
- Remove the application info sent on calls to Notify for now,
until/if something gets added to the spec about it.
Sat Jul 03 12:14:48 PDT 2004 Christian Hammond <chipx86@gnupdate.org>
* libnotify/notify.c:
* libnotify/notify.h:
- Removed the last of the request implementation.
- More work toward migrating the code to the specification.
- Simplified the action implementation a little bit.
Sat Jul 03 11:26:03 PDT 2004 Christian Hammond <chipx86@gnupdate.org>
* libnotify/notify.c:
* libnotify/notify.h:
- Cleaned up some things and updated some stuff to be compliant with
the spec. More will come soon.
Thu Jul 1 23:46:28 GMT 2004 Mike Hearn <mike@navi.cx>
* SPECIFICATION: Add info on icons/sounds, add some
protocol requests. Change "buttons" in the overview to "actions".
Wed Jun 30 14:03:51 GMT 2004 Mike Hearn <mike@navi.cx>
* SPECIFICATION: Initial version
Wed Jun 30 13:28:18 GMT 2004 Mike Hearn <mike@navi.cx>
* libnotify/notify.[ch]: Add file variables for emacs to match
the settings Christian is using.
Wed Jun 30 02:53:36 PDT 2004 Christian Hammond <chipx86@gnupdate.org>
* libnotify/notify.c:
- Free up the handle memory for a closed notification.
Tue Jun 29 19:33:43 PDT 2004 Christian Hammond <chipx86@gnupdate.org>
* libnotify/notify.c:
* libnotify/notify.h:
- Due to the new icon struct, a lot of redundant functions have now
been removed.
Tue Jun 29 19:26:58 PDT 2004 Christian Hammond <chipx86@gnupdate.org>
* libnotify/notify.c:
* libnotify/notify.h:
- Added a NotifyIcon struct and the beginnings of the API.
Tue Jun 29 18:49:38 PDT 2004 Christian Hammond <chipx86@gnupdate.org>
* libnotify/notify.c:
* libnotify/notify.h:
- Replaced the guint32 ID numbers that were passed around to represent
notifications and requests and replaced them with an opaque data
structure that abstracts that and other stuff.
Tue Jun 29 18:21:05 PDT 2004 Christian Hammond <chipx86@gnupdate.org>
* libnotify/notify.c:
- Changed 8 space to 4 space tabs.
Tue Jun 29 14:49:51 PDT 2004 Christian Hammond <chipx86@gnupdate.org>
* libnotify/notify.c:
- Patch by Mike Hearn to add a print_error() function for dumping
extra info when we have an error.
Sun Jun 27 21:50:33 PDT 2004 Christian Hammond <chipx86@gnupdate.org>
* configure.ac:
- Pass 0.0.1 as the version number to AC_INIT().
Sun Jun 27 21:39:13 PDT 2004 Christian Hammond <chipx86@gnupdate.org>
* libnotify/notify.c:
- Added support for the NotificationClosed and RequestClosed signals,
along with request callbacks. I wonder if any of this works.
Sun Jun 27 20:23:00 PDT 2004 Christian Hammond <chipx86@gnupdate.org>
* libnotify/notify.c:
- Keep track of request IDs so that we can do callback stuff in a bit.
Sun Jun 27 20:02:09 PDT 2004 Christian Hammond <chipx86@gnupdate.org>
* libnotify/notify.c:
- Send the list of button texts as a string array, rather than appending
each one individually.
Sun Jun 27 18:30:19 PDT 2004 Christian Hammond <chipx86@gnupdate.org>
* libnotify/notify.c:
* libnotify/notify.h:
- Split notify_close() into notify_close_notification() and
notify_close_request().
- Implement notify_send_request() and
notify_send_request_with_icon_data(), and add versions of those
functions that take a va_list for the buttons.
Sun Jun 27 16:46:32 PDT 2004 Christian Hammond <chipx86@gnupdate.org>
* libnotify/notify.c:
- Added a utility function for doing most of the D-BUS message
creation.
- Implemented notify_close_notification() and notify_close_request().
Sun Jun 27 16:38:42 PDT 2004 Christian Hammond <chipx86@gnupdate.org>
* libnotify/notify.c:
- Make sure we include our config.h if we have one.
Sun Jun 27 16:37:30 PDT 2004 Christian Hammond <chipx86@gnupdate.org>
* libnotify/notify.c:
* libnotify/notify.h:
- Added the initial header file and connection code.

229
INSTALL Normal file
View File

@ -0,0 +1,229 @@
Copyright (C) 1994, 1995, 1996, 1999, 2000, 2001, 2002 Free Software
Foundation, Inc.
This file is free documentation; the Free Software Foundation gives
unlimited permission to copy, distribute and modify it.
Basic Installation
==================
These are generic installation instructions.
The `configure' shell script attempts to guess correct values for
various system-dependent variables used during compilation. It uses
those values to create a `Makefile' in each directory of the package.
It may also create one or more `.h' files containing system-dependent
definitions. Finally, it creates a shell script `config.status' that
you can run in the future to recreate the current configuration, and a
file `config.log' containing compiler output (useful mainly for
debugging `configure').
It can also use an optional file (typically called `config.cache'
and enabled with `--cache-file=config.cache' or simply `-C') that saves
the results of its tests to speed up reconfiguring. (Caching is
disabled by default to prevent problems with accidental use of stale
cache files.)
If you need to do unusual things to compile the package, please try
to figure out how `configure' could check whether to do them, and mail
diffs or instructions to the address given in the `README' so they can
be considered for the next release. If you are using the cache, and at
some point `config.cache' contains results you don't want to keep, you
may remove or edit it.
The file `configure.ac' (or `configure.in') is used to create
`configure' by a program called `autoconf'. You only need
`configure.ac' if you want to change it or regenerate `configure' using
a newer version of `autoconf'.
The simplest way to compile this package is:
1. `cd' to the directory containing the package's source code and type
`./configure' to configure the package for your system. If you're
using `csh' on an old version of System V, you might need to type
`sh ./configure' instead to prevent `csh' from trying to execute
`configure' itself.
Running `configure' takes awhile. While running, it prints some
messages telling which features it is checking for.
2. Type `make' to compile the package.
3. Optionally, type `make check' to run any self-tests that come with
the package.
4. Type `make install' to install the programs and any data files and
documentation.
5. You can remove the program binaries and object files from the
source code directory by typing `make clean'. To also remove the
files that `configure' created (so you can compile the package for
a different kind of computer), type `make distclean'. There is
also a `make maintainer-clean' target, but that is intended mainly
for the package's developers. If you use it, you may have to get
all sorts of other programs in order to regenerate files that came
with the distribution.
Compilers and Options
=====================
Some systems require unusual options for compilation or linking that
the `configure' script does not know about. Run `./configure --help'
for details on some of the pertinent environment variables.
You can give `configure' initial values for configuration parameters
by setting variables in the command line or in the environment. Here
is an example:
./configure CC=c89 CFLAGS=-O2 LIBS=-lposix
*Note Defining Variables::, for more details.
Compiling For Multiple Architectures
====================================
You can compile the package for more than one kind of computer at the
same time, by placing the object files for each architecture in their
own directory. To do this, you must use a version of `make' that
supports the `VPATH' variable, such as GNU `make'. `cd' to the
directory where you want the object files and executables to go and run
the `configure' script. `configure' automatically checks for the
source code in the directory that `configure' is in and in `..'.
If you have to use a `make' that does not support the `VPATH'
variable, you have to compile the package for one architecture at a
time in the source code directory. After you have installed the
package for one architecture, use `make distclean' before reconfiguring
for another architecture.
Installation Names
==================
By default, `make install' will install the package's files in
`/usr/local/bin', `/usr/local/man', etc. You can specify an
installation prefix other than `/usr/local' by giving `configure' the
option `--prefix=PATH'.
You can specify separate installation prefixes for
architecture-specific files and architecture-independent files. If you
give `configure' the option `--exec-prefix=PATH', the package will use
PATH as the prefix for installing programs and libraries.
Documentation and other data files will still use the regular prefix.
In addition, if you use an unusual directory layout you can give
options like `--bindir=PATH' to specify different values for particular
kinds of files. Run `configure --help' for a list of the directories
you can set and what kinds of files go in them.
If the package supports it, you can cause programs to be installed
with an extra prefix or suffix on their names by giving `configure' the
option `--program-prefix=PREFIX' or `--program-suffix=SUFFIX'.
Optional Features
=================
Some packages pay attention to `--enable-FEATURE' options to
`configure', where FEATURE indicates an optional part of the package.
They may also pay attention to `--with-PACKAGE' options, where PACKAGE
is something like `gnu-as' or `x' (for the X Window System). The
`README' should mention any `--enable-' and `--with-' options that the
package recognizes.
For packages that use the X Window System, `configure' can usually
find the X include and library files automatically, but if it doesn't,
you can use the `configure' options `--x-includes=DIR' and
`--x-libraries=DIR' to specify their locations.
Specifying the System Type
==========================
There may be some features `configure' cannot figure out
automatically, but needs to determine by the type of machine the package
will run on. Usually, assuming the package is built to be run on the
_same_ architectures, `configure' can figure that out, but if it prints
a message saying it cannot guess the machine type, give it the
`--build=TYPE' option. TYPE can either be a short name for the system
type, such as `sun4', or a canonical name which has the form:
CPU-COMPANY-SYSTEM
where SYSTEM can have one of these forms:
OS KERNEL-OS
See the file `config.sub' for the possible values of each field. If
`config.sub' isn't included in this package, then this package doesn't
need to know the machine type.
If you are _building_ compiler tools for cross-compiling, you should
use the `--target=TYPE' option to select the type of system they will
produce code for.
If you want to _use_ a cross compiler, that generates code for a
platform different from the build platform, you should specify the
"host" platform (i.e., that on which the generated programs will
eventually be run) with `--host=TYPE'.
Sharing Defaults
================
If you want to set default values for `configure' scripts to share,
you can create a site shell script called `config.site' that gives
default values for variables like `CC', `cache_file', and `prefix'.
`configure' looks for `PREFIX/share/config.site' if it exists, then
`PREFIX/etc/config.site' if it exists. Or, you can set the
`CONFIG_SITE' environment variable to the location of the site script.
A warning: not all `configure' scripts look for a site script.
Defining Variables
==================
Variables not defined in a site shell script can be set in the
environment passed to `configure'. However, some packages may run
configure again during the build, and the customized values of these
variables may be lost. In order to avoid this problem, you should set
them in the `configure' command line, using `VAR=value'. For example:
./configure CC=/usr/local2/bin/gcc
will cause the specified gcc to be used as the C compiler (unless it is
overridden in the site shell script).
`configure' Invocation
======================
`configure' recognizes the following options to control how it
operates.
`--help'
`-h'
Print a summary of the options to `configure', and exit.
`--version'
`-V'
Print the version of Autoconf used to generate the `configure'
script, and exit.
`--cache-file=FILE'
Enable the cache: use and save the results of the tests in FILE,
traditionally `config.cache'. FILE defaults to `/dev/null' to
disable caching.
`--config-cache'
`-C'
Alias for `--cache-file=config.cache'.
`--quiet'
`--silent'
`-q'
Do not print messages saying which checks are being made. To
suppress all normal output, redirect it to `/dev/null' (any error
messages will still be shown).
`--srcdir=DIR'
Look for the package's source code in directory DIR. Usually
`configure' can determine that directory automatically.
`configure' also accepts some other, not widely useful, options. Run
`configure --help' for more details.

46
Makefile.am Normal file
View File

@ -0,0 +1,46 @@
ACLOCAL_AMFLAGS = -I m4
SUBDIRS = libnotify docs tools tests
pcdata_DATA = libnotify.pc
pcdatadir = $(libdir)/pkgconfig
EXTRA_DIST = \
AUTHORS NEWS INSTALL COPYING README \
ChangeLog \
autogen.sh \
configure.ac \
libnotify.pc.in
$(OBJECTS): libtool
libtool: $(LIBTOOL_DEPS)
$(SHELL) ./config.status --recheck
doxygen:
@echo "Running doxygen..."
@doxygen Doxyfile
DISTCHECK_CONFIGURE_FLAGS = --enable-gtk-doc
MAINTAINERCLEANFILES = \
$(srcdir)/INSTALL \
$(srcdir)/aclocal.m4 \
$(srcdir)/autoscan.log \
$(srcdir)/compile \
$(srcdir)/config.guess \
$(srcdir)/config.h.in \
$(srcdir)/config.sub \
$(srcdir)/configure.scan \
$(srcdir)/depcomp \
$(srcdir)/install-sh \
$(srcdir)/ltmain.sh \
$(srcdir)/missing \
$(srcdir)/mkinstalldirs \
$(srcdir)/omf.make \
$(srcdir)/xmldocs.make \
$(srcdir)/gtk-doc.make \
$(srcdir)/ChangeLog \
`find "$(srcdir)" -type f -name Makefile.in -print`
-include $(top_srcdir)/git.mk

164
NEWS
View File

@ -1,165 +1,11 @@
New in 0.8.1
============
* Keep version of bindings at 0.7 (#27) [Marco]
Contributors:
Marco Trevisan
New in 0.8.0
============
* Use Desktop Portal Notification when running confined (snap and flatpak)
Now the library acts like a wrapper in such scenario, with some limited
capabilities, but this will enforce security and user control over the
allowed notifications. [Marco]
* notify-send: Handles SIGINT gracefully, closing waiting notification [Marco]
* Use NotifyClosedReason enum as closed reason return value [Marco]
* Bump dependency on GLib 2.38 [Marco]
* Various introspection docs improvements and fixes [Marco]
Contributors:
Marco Trevisan
New in 0.7.12
=============
* docs/notify-send: Add --transient option to manpage [Marco]
* notify-send: Move server capabilities check to a separate function [Marco]
* notify-send: Add debug message about server not supporting persistence
[Marco]
* notification: Include sender-pid hint by default if not provided [Marco]
* Delete unused notifynotification.xml [Patrick; !25]
* notification: Bookend calling NotifyActionCallback with temporary ref
[Logan; #25, !26]
Contributors:
Marco Trevisan, Patrick Griffis, Logan Rathbone
New in 0.7.11
=============
* Fix potential build errors with old glib version we require
* notify-send: Add support for boolean hints
* notify-send: Support passing any hint value, by parsing variant strings
* notify-send: Add explicit option to create transient notifications
Contributors:
Marco Trevisan
New in 0.7.10
=============
* notify-send: Support commas in icon filenames [Thorsten; !15]
* notify-send: Give failing exit code if showing notification fails [Ray, !13]
* notify-send: Support for replacing an existing notification [Paul; !17]
* notify-send: Add option to wait until notification has been closed [Ben; !18]
* notify-send: Add support for notification actions and responses [Ben; !18]
* notification: Send the application ID when possible [Corentin; !1]
* notification: Use g_memdup2 when available [Marco; !22]
* notification: Improve SNAP detection and confined desktop ID [Marco; !23]
* notification: Add support for getting actions activation token [Marco; !24]
* notify: Use application ID if any to set the fallback app name [Marco; !18]
* Build fixes and improvements [Marco; !22]
* Docs updates [Boris, David; !14, !20]
Contributors:
Marco Trevisan, Boris Shtrasman, Matthias Sweertvaegher, Thorsten Wißmann,
Ray Strode, Maximiliano Sandoval R, David King, Corentin Noël, Paul Collins,
Matthias Sweertvaegher, Ben Blain
New in 0.7.9
============
* Fixed linking in darwin [Iain, Marco; !5]
* Added man page for notify-send [Jan; !6]
* Dropped autotools [Jan; !11]
Contributors:
Iain Lane, Jan Tojnar, Marco Trevisan
New in 0.7.8
============
* Support meson build system [Marco; !3]
* notify-send: Support full URLs as hint values [Marco; !4]
* Mic. bug fixes [Ting-Wei, Florian; #760438, !8]
Contributors:
Emmanuele Bassi, Abderrahim Kitouni, Ting-Wei Lan, Iain Lane, Florian Müllner,
Jan Tojnar, Marco Trevisan (Treviño), Marco Trevisan
New in 0.7.7
============
- Introspection fixes (Evan Nemerson)
- Allow to disable tests at build time (Quentin Glidic)
New in 0.7.6
============
- Fix annotation for add_action (Giovanni Campagna)
- Clarify documentation for set-timeout (Matthias Clasen)
New in 0.7.5
============
- Build fixes (Colin Walters)
- Documentation improvements (Javier Jardón)
- Spec clarifications (Matthias Clasen)
New in 0.7.4
============
- Improve documentation of supported image data formats (Colin Walters)
- Honor aclocal flags (Craig Keogh)
- Update autotools configuration (Javier Jardón)
- Test notification removal (William Jon McCann)
NEW in 0.7.3:
NEW in 0.5.2:
==============
- Add a way to change the application name for
individual notifications (Richard Hughes)
Note that the 0.5.1 release was released from the 0.6 branch in error.
Sorry about that.
NEW in 0.7.2:
==============
- Add a way to change the application name (William Jon McCann)
- Mark image_path as deprecated (William Jon McCann)
- Allow properties to be set in any order (Matthias Clasen)
NEW in 0.7.1:
==============
- Don't export private symbols (Emilio Pozuelo Monfort)
- Introspection support and annotations (Jonathan Matthew, Martin Pitt)
- Documentation cleanups and fixes (Javier Jardón)
- Ref the pixbuf passed to set_image_from_pixbuf (Guillaume Desmottes)
- Add tests for new capabilities and hints (William Jon McCann)
- Update spec to mention "persistence" and "action-icons" server
capability and "action-icons", "transient" and "resident" hints.
Bump spec version to 1.2 (William Jon McCann)
NEW in 0.7.0:
==============
- Remove the ability to attach notifications to widgets or positions
- Add a test for the persistence server capability
- Port to use GBus instead of dbus-glib (Christian Persch)
- Add a macro to get library version number
- Remove GTK+ dependency from library
- Port tests to GTK+ 3
NEW in 0.6.0:
==============
The 0.5.1 release included changes that should not have been made on a
stable branch. It should have been a 0.6 series release. So here it is.
- Fixed #623096 Fix notify_get_server_info results
NEW in 0.5.1:
==============
- Remove explicit GTK+ 2.x linking, so that libnotify can link against
both GTK+ 2.x or GTK+ 3.x
- Fixed #623096, Use correct variable in NULL check
- Added a macro NOTIFY_CHECK_VERSION
NEW in 0.5.0:
==============

0
README Normal file
View File

20
README.md
View File

@ -1,20 +0,0 @@
# libnotify
## Description
libnotify is a library for sending desktop notifications to a notification
daemon, as defined in the [org.freedesktop.Notifications][fdo-spec] Desktop
Specification. 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.
It is also a simple wrapper to send cross-desktop Notifications for sandboxed
applications using the [XDG Portal Notification API][portal].
## Notice
For GLib based applications the [GNotification][gnotif] API should be used
instead.
[fdo-spec]: https://specifications.freedesktop.org/notification-spec/notification-spec-latest.html
[gnotif]: https://docs.gtk.org/gio/class.Notification.html
[portal]: https://github.com/flatpak/xdg-desktop-portal/blob/main/data/org.freedesktop.portal.Notification.xml

22
autogen.sh Executable file
View File

@ -0,0 +1,22 @@
#!/bin/sh
# Run this to generate all the initial makefiles, etc.
srcdir=`dirname $0`
test -z "$srcdir" && srcdir=.
PKG_NAME="libnotify"
REQUIRED_AUTOMAKE_VERSION=1.9
(test -f $srcdir/configure.ac \
&& test -d $srcdir/libnotify) || {
echo -n "**Error**: Directory "\`$srcdir\'" does not look like the"
echo " top-level $PKG_NAME directory"
exit 1
}
which gnome-autogen.sh || {
echo "You need to install gnome-common."
exit 1
}
. gnome-autogen.sh

4
config.h.meson
View File

@ -1,4 +0,0 @@
/* config.h.meson */
/* Version number of package */
#mesondefine VERSION

232
configure.ac Normal file
View File

@ -0,0 +1,232 @@
dnl Process this file with autoconf to create configure.
dnl ################################################################
dnl # Initialize autoconf
dnl ################################################################
AC_INIT([libnotify],[0.5.2],[https://bugzilla.gnome.org/enter_bug.cgi?product=libnotify],[libnotify])
AC_PREREQ(2.50)
AC_CONFIG_SRCDIR(config.h.in)
AC_CONFIG_MACRO_DIR([m4])
dnl ################################################################
dnl # Version information
dnl ################################################################
LIBNOTIFY_MAJOR_VERSION=0
LIBNOTIFY_MINOR_VERSION=5
LIBNOTIFY_MICRO_VERSION=2
LIBNOTIFY_DEVEL_VERSION=0
AC_SUBST(LIBNOTIFY_MAJOR_VERSION)
AC_SUBST(LIBNOTIFY_MINOR_VERSION)
AC_SUBST(LIBNOTIFY_MICRO_VERSION)
LIBNOTIFY_VERSION=$LIBNOTIFY_MAJOR_VERSION.$LIBNOTIFY_MINOR_VERSION.$LIBNOTIFY_MICRO_VERSION
if test "x$LIBNOTIFY_DEVEL_VERSION" != "x0"; then
LIBNOTIFY_VERSION=$LIBNOTIFY_VERSION.$LIBNOTIFY_DEVEL_VERSION
fi
AC_DEFINE_UNQUOTED(LIBNOTIFY_MAJOR_VERSION, $LIBNOTIFY_MAJOR_VERSION,
[libnotify major version.])
AC_DEFINE_UNQUOTED(LIBNOTIFY_MINOR_VERSION, $LIBNOTIFY_MINOR_VERSION,
[libnotify minor version.])
AC_DEFINE_UNQUOTED(LIBNOTIFY_MICRO_VERSION, $LIBNOTIFY_MICRO_VERSION,
[libnotify micro version.])
AC_DEFINE_UNQUOTED(LIBNOTIFY_VERSION, "$LIBNOTIFY_VERSION",
[libnotify version.])
dnl ################################################################
dnl # libtool versioning
dnl ################################################################
dnl #
dnl # +1 : 0 : +1 == new interface that does not break old one.
dnl # +1 : 0 : 0 == removed an interface. Breaks old apps.
dnl # ? : +1 : ? == internal changes that doesn't break anything.
dnl #
dnl # CURRENT : REVISION : AGE
dnl #
LT_CURRENT=4
LT_REVISION=0
LT_AGE=3
LT_RELEASE=$LIBNOTIFY_MAJOR_VERSION.$LIBNOTIFY_MINOR_VERSION.$LIBNOTIFY_MICRO_VERSION
AC_SUBST(LT_RELEASE)
AC_SUBST(LT_CURRENT)
AC_SUBST(LT_REVISION)
AC_SUBST(LT_AGE)
dnl ################################################################
dnl # Initialize automake
dnl ################################################################
VERSION=$LIBNOTIFY_VERSION
PACKAGE=libnotify
AM_INIT_AUTOMAKE([1.10 no-dist-gzip dist-bzip2])
m4_ifdef([AM_SILENT_RULES], [AM_SILENT_RULES([yes])])
dnl ################################################################
dnl # Specify a header configuration file
dnl ################################################################
AM_CONFIG_HEADER(config.h)
dnl ################################################################
dnl # Check for some standard stuff.
dnl ################################################################
AC_PROG_CC
#AC_ARG_PROGRAM
AC_PROG_CPP
AC_PROG_MAKE_SET
AC_PROG_LN_S
AC_PROG_INSTALL
AC_C_CONST
AC_TYPE_SIZE_T
AC_EXEEXT
AM_PROG_LIBTOOL
REQ_DBUS_VERSION=0.76
REQ_GTK_VERSION=2.18
REQ_GLIB_VERSION=2.6
pkg_modules="gtk+-2.0 >= $REQ_GTK_VERSION, glib-2.0 >= $REQ_GLIB_VERSION, dbus-1 >= $REQ_DBUS_VERSION, dbus-glib-1 >= $REQ_DBUS_VERSION"
AC_SUBST(pkg_modules)
PKG_CHECK_MODULES(PACKAGE, [$pkg_modules])
AC_SUBST(PACKAGE_CFLAGS)
AC_SUBST(PACKAGE_LIBS)
GLIB_GENMARSHAL=`pkg-config --variable=glib_genmarshal glib-2.0`
AC_SUBST(GLIB_GENMARSHAL)
dnl
dnl Check the D-BUS version.
dnl
AC_MSG_CHECKING([dbus version])
DBUS_VERSION=`$PKG_CONFIG --modversion dbus-1`
DBUS_MAJOR_VER=`echo $DBUS_VERSION | cut -d. -f 1`
DBUS_MINOR_VER=`echo $DBUS_VERSION | cut -d. -f 2`
DBUS_MICRO_VER=`echo $DBUS_VERSION | cut -d. -f 3`
AC_MSG_RESULT($DBUS_VERSION)
AC_DEFINE_UNQUOTED(DBUS_MAJOR_VER, $DBUS_MAJOR_VER, [D-BUS major version.])
AC_DEFINE_UNQUOTED(DBUS_MINOR_VER, $DBUS_MINOR_VER, [D-BUS minor version.])
AC_DEFINE_UNQUOTED(DBUS_MICRO_VER, $DBUS_MICRO_VER, [D-BUS micro version.])
AC_DEFINE_UNQUOTED(DBUS_API_SUBJECT_TO_CHANGE, ,DBUS API is subject to change)
dnl ################################################################
dnl # Set up gtk-doc
dnl ################################################################
GTK_DOC_CHECK([1.4])
dnl ---------------------------------------------------------------------------
dnl - DocBook Documentation
dnl ---------------------------------------------------------------------------
AC_ARG_ENABLE(docbook-docs,
[AC_HELP_STRING([--enable-docbook-docs],
[build documentation (requires xmlto)])],
enable_docbook_docs=$enableval,enable_docbook_docs=no)
AC_PATH_PROG(XMLTO, xmlto, no)
AC_MSG_CHECKING([whether to build DocBook documentation])
if test x$XMLTO = xno ; then
have_docbook=no
else
have_docbook=yes
fi
if test x$enable_docbook_docs = xauto ; then
if test x$have_docbook = xno ; then
enable_docbook_docs=no
else
enable_docbook_docs=yes
fi
fi
if test x$enable_docbook_docs = xyes; then
if test x$have_docbook = xno; then
AC_MSG_ERROR([Building DocBook docs explicitly required, but DocBook not found])
fi
fi
AM_CONDITIONAL(DOCBOOK_DOCS_ENABLED, test x$enable_docbook_docs = xyes)
AC_MSG_RESULT(yes)
AC_ARG_VAR([XMLTO],[Define/override the `xmlto' location.])
AC_ARG_VAR([XMLTO_FLAGS],[Define/override `xmlto' options, like `--skip-validation'.])
# Turn on the additional warnings last
AC_ARG_ENABLE(more-warnings,
AS_HELP_STRING([--enable-more-warnings],
[Maximum compiler warnings]),
set_more_warnings="$enableval",[
if test -d $srcdir/.git; then
set_more_warnings=yes
else
set_more_warnings=no
fi])
AC_MSG_CHECKING(for more warnings)
if test "$GCC" = "yes" -a "$set_more_warnings" != "no"; then
AC_MSG_RESULT(yes)
CFLAGS="\
-Wall \
-Wchar-subscripts -Wmissing-declarations -Wmissing-prototypes \
-Wnested-externs -Wpointer-arith \
-Wcast-align -Wsign-compare -Wp,-D_FORTIFY_SOURCE=2 \
$CFLAGS"
for option in -Wno-strict-aliasing -Wno-sign-compare; do
SAVE_CFLAGS="$CFLAGS"
CFLAGS="$CFLAGS $option"
AC_MSG_CHECKING([whether gcc understands $option])
AC_TRY_COMPILE([], [],
has_option=yes,
has_option=no,)
if test $has_option = no; then
CFLAGS="$SAVE_CFLAGS"
fi
AC_MSG_RESULT($has_option)
unset has_option
unset SAVE_CFLAGS
done
unset option
else
AC_MSG_RESULT(no)
fi
AC_SUBST(CFLAGS)
dnl ################################################################
dnl # Output the Makefiles
dnl ################################################################
AC_CONFIG_FILES([
Makefile
docs/Makefile
docs/reference/Makefile
libnotify.pc
libnotify/Makefile
libnotify/notify-features.h
tests/Makefile
tools/Makefile
])
AC_OUTPUT
echo "
$PACKAGE $VERSION
========================
prefix: ${prefix}
exec_prefix: ${exec_prefix}
bindir: ${bindir}
datadir: ${datadir}
source code location: ${srcdir}
cflags: ${CFLAGS}
Build docs: ${enable_docbook_docs}
"

25
docs/Makefile.am Normal file
View File

@ -0,0 +1,25 @@
NULL =
SUBDIRS = reference
SPEC_XML_FILES = \
notification-spec.xml \
$(NULL)
if DOCBOOK_DOCS_ENABLED
htmldocdir = $(docdir)/spec
htmldoc_DATA = notification-spec.html
notification-spec.html: $(SPEC_XML_FILES)
$(XMLTO) $(XMLTO_FLAGS) xhtml-nochunks -m $(top_srcdir)/docs/config.xsl notification-spec.xml
endif # DOCBOOK_DOCS_ENABLED
EXTRA_DIST = \
ChangeLog \
$(SPEC_XML_FILES) \
$(NULL)
-include $(top_srcdir)/git.mk

1
docs/config.xsl
View File

@ -3,5 +3,4 @@
xmlns:fo="http://www.w3.org/1999/XSL/Format"
version="1.0">
<xsl:param name="html.stylesheet" select="'docbook.css'"/>
<xsl:param name="generate.consistent.ids" select="1"/>
</xsl:stylesheet>

40
docs/meson.build
View File

@ -1,40 +0,0 @@
docbook_docs = get_option('docbook_docs')
if not docbook_docs.disabled()
xmlto = find_program('xmlto', required: docbook_docs.enabled())
if xmlto.found()
spec_files = ['notification-spec']
foreach spec: spec_files
custom_target(spec + '.html',
output: spec + '.html',
input: spec + '.xml',
depend_files: 'config.xsl',
command: [xmlto,
'xhtml-nochunks',
'-m', join_paths(meson.current_source_dir(), 'config.xsl'),
'-o', '@OUTDIR@',
'@INPUT@'
],
install: true,
install_dir: join_paths(docdir, 'spec'))
endforeach
endif
endif
if get_option('gtk_doc')
subdir('reference')
endif
if get_option('man')
manpages = ['notify-send']
foreach page : manpages
custom_target(page + '-man',
input: page + '.xml',
output: page + '.1',
command: xsltproc_command,
install: true,
install_dir: man1dir)
endforeach
endif

313
docs/notification-spec.xml
View File

@ -1,10 +1,10 @@
<?xml version="1.0"?>
<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd">
<!DOCTYPE article PUBLIC "-//OASIS/DTD DocBook XML V4.1.2//EN" "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd">
<article id="index">
<articleinfo>
<title>Desktop Notifications Specification</title>
<releaseinfo>Version 1.2</releaseinfo>
<date>28 October 2010</date>
<releaseinfo>Version 1.1</releaseinfo>
<date>25 August 2007</date>
<authorgroup>
<author>
<firstname>Mike</firstname>
@ -24,24 +24,99 @@
</address>
</affiliation>
</author>
<author>
<firstname>William Jon</firstname>
<surname>McCann</surname>
<affiliation>
<address>
<email>jmccann@redhat.com</email>
</address>
</affiliation>
</author>
</authorgroup>
<revhistory>
<revision>
<revnumber>1.0</revnumber>
<date>25 August 2007</date>
<authorinitials>cdh</authorinitials>
<revremark>
Added spec_version to the GetServerInformation return values.
Mark this specification as a 1.0.
</revremark>
</revision>
<revision>
<revnumber>0.9</revnumber>
<date>15 January 2006</date>
<authorinitials>cdh</authorinitials>
<revremark>
Clarify the naming for the application IDs.
Put back a number of things that probably shouldn't have been removed
from the spec.
</revremark>
</revision>
<revision>
<revnumber>0.8</revnumber>
<date>23 September 2005</date>
<authorinitials>J5</authorinitials>
<revremark>
Major overhaul of spec to work with the newer D-Bus recursive type system.
Simplify protocol.
Changed the verbage notification type to category
</revremark>
</revision>
<revision>
<revnumber>0.7</revnumber>
<date>28 July 2005</date>
<authorinitials>cdh</authorinitials>
<revremark>
Added "x" and "y" hints. Talk about the variant type for hint values.
</revremark>
</revision>
<revision>
<revnumber>0.6</revnumber>
<date>1 April 2005</date>
<authorinitials>cdh</authorinitials>
<revremark>
Updated to work with D-BUS 0.31+.
</revremark>
</revision>
<revision>
<revnumber>0.5</revnumber>
<date>2 October 2004</date>
<authorinitials>cdh</authorinitials>
<revremark>
Added a "suppress-sound" hint. Added a "sound" capability. Renamed the
"soundfile" hint to sound-file".
</revremark>
</revision>
<revision>
<revnumber>0.4</revnumber>
<date>29 September 2004</date>
<authorinitials>cdh</authorinitials>
<revremark>
Added image support in markup, and made the restrictions on markup more
clear. Removed the High urgency. Added new notification types. Fixed
notification expiration.
</revremark>
</revision>
<revision>
<revnumber>0.3</revnumber>
<date>15 September 2004</date>
<authorinitials>cdh</authorinitials>
<revremark>Added hint and notification type sections</revremark>
</revision>
<revision>
<revnumber>0.2</revnumber>
<date>foo</date>
<authorinitials>mh</authorinitials>
<revremark>Added replaces field to protocol</revremark>
</revision>
<revision>
<revnumber>0.1</revnumber>
<date>foo</date>
<authorinitials>mh</authorinitials>
<revremark>Initial version</revremark>
</revision>
</revhistory>
</articleinfo>
<sect1 id="introduction">
<title>Introduction</title>
<para>
This is a draft standard for a desktop notifications service,
through which applications can generate passive popups to notify
the user in an asynchronous manner of events.
This is a draft standard for a desktop notifications service, through
which applications can generate passive popups (sometimes known as
"poptarts") to notify the user in an asynchronous manner of events.
</para>
<para>
This specification explicitly does not include other types of
@ -52,7 +127,13 @@
Example use cases include:
</para>
<itemizedlist>
<listitem><para>Messages from chat programs</para> </listitem>
<listitem>
<para>
Presence changes in IM programs: for instance, MSN Messenger on
Windows pioneered the use of passive popups to indicate presence
changes.
</para>
</listitem>
<listitem><para>Scheduled alarm</para></listitem>
<listitem><para>Completed file transfer</para></listitem>
<listitem><para>New mail notification</para></listitem>
@ -349,7 +430,7 @@
</para>
<para>
The icon is defined by the "app_icon" parameter.
The image can be defined by the "image-path", the "image-data" hint or the
The image can be defined by the "image_path", the "image_data" hint or the
deprecated "icon_data" hint.
</para>
<sect2>
@ -358,8 +439,8 @@
An implementation which only displays one image or icon must choose which one
to display using the following order:
<orderedlist>
<listitem><para>"image-data"</para></listitem>
<listitem><para>"image-path"</para></listitem>
<listitem><para>"image_data"</para></listitem>
<listitem><para>"image_path"</para></listitem>
<listitem><para>app_icon parameter</para></listitem>
<listitem><para>for compatibility reason, "icon_data"</para></listitem>
</orderedlist>
@ -370,8 +451,8 @@
icon from the "app_icon" parameter and choose which image to display using
the following order:
<orderedlist>
<listitem><para>"image-data"</para></listitem>
<listitem><para>"image-path"</para></listitem>
<listitem><para>"image_data"</para></listitem>
<listitem><para>"image_path"</para></listitem>
<listitem><para>for compatibility reason, "icon_data"</para></listitem>
</orderedlist>
</para>
@ -380,21 +461,12 @@
<sect2 id="icons-and-images-formats" xreflabel="Icons and Images Formats">
<title>Formats</title>
<para>
The "image-data" and "icon_data" hints should be a DBus structure
of signature (iiibiiay). The components of this structure are as follows:
<orderedlist>
<listitem><para>width (i): Width of image in pixels</para></listitem>
<listitem><para>height (i): Height of image in pixels</para></listitem>
<listitem><para>rowstride (i): Distance in bytes between row starts</para></listitem>
<listitem><para>has_alpha (b): Whether the image has an alpha channel</para></listitem>
<listitem><para>bits_per_sample (i): Must always be 8</para></listitem>
<listitem><para>channels (i): If has_alpha is TRUE, must be 4, otherwise 3</para></listitem>
<listitem><para>data (ay): The image data, in RGB byte order</para></listitem>
</orderedlist>
This image format is derived from <ulink url="http://developer.gnome.org/gdk-pixbuf/stable/">gdk-pixbuf</ulink>.
The "image_data" and "icon_data" hints should be a raw image data structure
of signature (iiibiiay) which describes the width, height, rowstride, has
alpha, bits per sample, channels and image data respectively.
</para>
<para>
The "app_icon" parameter and "image-path" hint should be either an URI
The "app_icon" parameter and "image_path" hint should be either an URI
(file:// is the only URI schema supported right now) or a name in a
freedesktop.org-compliant icon theme (not a GTK+ stock ID).
</para>
@ -662,20 +734,16 @@
</thead>
<tbody valign="top">
<row>
<entry><literal>"action-icons"</literal></entry>
<entry>BOOLEAN</entry>
<entry><literal>"urgency"</literal></entry>
<entry>byte</entry>
<entry>
When set, a server that has the "action-icons" capability will
attempt to interpret any action identifier as a named icon.
The localized display name will be used to annotate the icon
for accessibility purposes. The icon name should be compliant
with the Freedesktop.org Icon Naming Specification.
The urgency level.
</entry>
<entry>&gt;= 1.2</entry>
<entry/>
</row>
<row>
<entry><literal>"category"</literal></entry>
<entry>STRING</entry>
<entry>string</entry>
<entry>
The type of notification this is.
</entry>
@ -683,7 +751,7 @@
</row>
<row>
<entry><literal>"desktop-entry"</literal></entry>
<entry>STRING</entry>
<entry>string</entry>
<entry>
This specifies the name of the desktop filename representing the
calling program. This should be the same as the prefix used for the
@ -694,62 +762,34 @@
<entry/>
</row>
<row>
<entry><literal>"image-data"</literal></entry>
<entry><literal>"image_data"</literal></entry>
<entry>(iiibiiay)</entry>
<entry>
This is a raw data image format which describes the width, height,
rowstride, has alpha, bits per sample, channels and image data
respectively.
</entry>
<entry>&gt;= 1.2</entry>
</row>
<row>
<entry><literal>"image_data"</literal></entry>
<entry>(iiibiiay)</entry>
<entry>
<emphasis>Deprecated</emphasis>. Use image-data instead.
</entry>
<entry>= 1.1</entry>
</row>
<row>
<entry><literal>"image-path"</literal></entry>
<entry>STRING</entry>
<entry>
Alternative way to define the notification image. See <xref linkend="icons-and-images"/>.
</entry>
<entry>&gt;= 1.2</entry>
<entry>&gt;= 1.1</entry>
</row>
<row>
<entry><literal>"image_path"</literal></entry>
<entry>STRING</entry>
<entry>string</entry>
<entry>
<emphasis>Deprecated</emphasis>. Use image-path instead.
Alternative way to define the notification image. See <xref linkend="icons-and-images"/>.
</entry>
<entry>= 1.1</entry>
<entry>&gt;= 1.1</entry>
</row>
<row>
<entry><literal>"icon_data"</literal></entry>
<entry>(iiibiiay)</entry>
<entry>
<emphasis>Deprecated</emphasis>. Use image-data instead.
<emphasis>Deprecated</emphasis>. Use image_data instead.
</entry>
<entry>&lt; 1.1</entry>
</row>
<row>
<entry><literal>"resident"</literal></entry>
<entry>BOOLEAN</entry>
<entry>
When set the server will not automatically remove the
notification when an action has been invoked. The notification
will remain resident in the server until it is explicitly
removed by the user or by the sender. This hint is likely only
useful when the server has the "persistence" capability.
</entry>
<entry>&gt;= 1.2</entry>
</row>
<row>
<entry><literal>"sound-file"</literal></entry>
<entry>STRING</entry>
<entry>string</entry>
<entry>
The path to a sound file to play when the notification pops up.
</entry>
@ -757,7 +797,7 @@
</row>
<row>
<entry><literal>"sound-name"</literal></entry>
<entry>STRING</entry>
<entry>string</entry>
<entry>
A themeable named sound from the freedesktop.org
<ulink url="http://0pointer.de/public/sound-naming-spec.html">sound naming specification</ulink>
@ -768,7 +808,7 @@
</row>
<row>
<entry><literal>"suppress-sound"</literal></entry>
<entry>BOOLEAN</entry>
<entry>boolean</entry>
<entry>
Causes the server to suppress playing any sounds, if it has that
ability. This is usually set when the client itself is going to
@ -776,19 +816,9 @@
</entry>
<entry/>
</row>
<row>
<entry><literal>"transient"</literal></entry>
<entry>BOOLEAN</entry>
<entry>
When set the server will treat the notification as transient
and by-pass the server's persistence capability, if it should
exist.
</entry>
<entry>&gt;= 1.2</entry>
</row>
<row>
<entry><literal>"x"</literal></entry>
<entry>INT32</entry>
<entry>int</entry>
<entry>
Specifies the X location on the screen that the notification should
point to. The <literal>"y"</literal> hint must also be specified.
@ -797,21 +827,13 @@
</row>
<row>
<entry><literal>"y"</literal></entry>
<entry>INT32</entry>
<entry>int</entry>
<entry>
Specifies the Y location on the screen that the notification should
point to. The <literal>"x"</literal> hint must also be specified.
</entry>
<entry/>
</row>
<row>
<entry><literal>"urgency"</literal></entry>
<entry>BYTE</entry>
<entry>
The urgency level.
</entry>
<entry/>
</row>
</tbody>
</tgroup>
</table>
@ -831,7 +853,7 @@
<title><literal>org.freedesktop.Notifications.GetCapabilities</literal></title>
<funcsynopsis>
<funcprototype>
<funcdef>as
<funcdef>STRING_ARRAY
<function>org.freedesktop.Notifications.GetCapabilities</function>
</funcdef>
<void/>
@ -849,14 +871,6 @@
<title>Server Capabilities</title>
<tgroup cols="2">
<tbody valign="top">
<row>
<entry><literal>"action-icons"</literal></entry>
<entry>
Supports using icons instead of text for displaying actions.
Using icons for actions must be enabled on a per-notification
basis using the "action-icons" hint.
</entry>
</row>
<row>
<entry><literal>"actions"</literal></entry>
<entry>
@ -910,18 +924,6 @@
server to specify both.
</entry>
</row>
<row>
<entry><literal>"persistence"</literal></entry>
<entry>
The server supports persistence of notifications.
Notifications will be retained until they are acknowledged or
removed by the user or recalled by the sender. The presence
of this capability allows clients to depend on the server to
ensure a notification is seen and eliminate the need for
the client to display a reminding function (such as a status
icon) of its own.
</entry>
</row>
<row>
<entry><literal>"sound"</literal></entry>
<entry>
@ -954,8 +956,8 @@
<paramdef>STRING <parameter>app_icon</parameter></paramdef>
<paramdef>STRING <parameter>summary</parameter></paramdef>
<paramdef>STRING <parameter>body</parameter></paramdef>
<paramdef>as <parameter>actions</parameter></paramdef>
<paramdef>a{sv} <parameter>hints</parameter></paramdef>
<paramdef>ARRAY <parameter>actions</parameter></paramdef>
<paramdef>DICT <parameter>hints</parameter></paramdef>
<paramdef>INT32 <parameter>expire_timeout</parameter></paramdef>
</funcprototype>
</funcsynopsis>
@ -1013,7 +1015,7 @@
</row>
<row>
<entry><parameter>actions</parameter></entry>
<entry>as</entry>
<entry>ARRAY</entry>
<entry>
Actions are sent over as a list of pairs. Each even element in
the list (starting at index 0) represents the identifier for the
@ -1023,7 +1025,7 @@
</row>
<row>
<entry><parameter>hints</parameter></entry>
<entry>a{sv}</entry>
<entry>DICT</entry>
<entry>
Optional hints that can be passed to the server from the client
program. Although clients and servers should never assume each other
@ -1272,65 +1274,6 @@
</para>
</note>
</sect3>
<sect3 id="signal-activation-token">
<title><literal>org.freedesktop.Notifications.ActivationToken</literal></title>
<funcsynopsis>
<funcprototype>
<funcdef>
<function>org.freedesktop.Notifications.ActivationToken</function>
</funcdef>
<paramdef>UINT32 <parameter>id</parameter></paramdef>
<paramdef>STRING <parameter>activation_token</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
This signal can be emitted before a <literal>ActionInvoked</literal>
signal. It carries an activation token that can be used to activate a
toplevel.
</para>
<table>
<title>ActivationToken Parameters</title>
<tgroup cols="2">
<thead>
<row>
<entry>Name</entry>
<entry>Type</entry>
<entry>Description</entry>
</row>
</thead>
<tbody valign="top">
<row>
<entry><parameter>id</parameter></entry>
<entry>UINT32</entry>
<entry>
The ID of the notification emitting the <literal>ActionInvoked</literal>
signal.
</entry>
</row>
<row>
<entry><parameter>activation_token</parameter></entry>
<entry>STRING</entry>
<entry>
An activation token. This can be either an X11-style startup ID (see
<ulink url="https://specifications.freedesktop.org/startup-notification-spec/startup-notification-latest.txt">Startup notification protocol</ulink>)
or a
<ulink url="https://gitlab.freedesktop.org/wayland/wayland-protocols/-/tree/main/staging/xdg-activation">Wayland xdg-activation</ulink>
token.
</entry>
</row>
</tbody>
</tgroup>
</table>
<note>
<para>
Clients should not assume the server will generate this signal. Some
servers may not support user interaction at all, or may not support
the concept of being able to generate an activation token for a
notification.
</para>
</note>
</sect3>
</sect2>
</sect1>
</article>

138
docs/notify-send.xml
View File

@ -1,138 +0,0 @@
<refentry xmlns="http://docbook.org/ns/docbook" version="5.0" xmlns:xlink="http://www.w3.org/1999/xlink">
<info>
<date>November 2005</date>
<productname>libnotify</productname>
<authorgroup>
<author>
<personname>Andre Filipe de Assuncao e Brito</personname>
<email>decko@noisemakers.org</email>
<contrib>Original author</contrib>
</author>
<author>
<personname>Paul van Tilburg</personname>
<email>paulvt@debian.org</email>
<contrib>Original author</contrib>
</author>
<author>
<personname>Riccardo Setti</personname>
<email>giskard@debian.org</email>
<contrib>Original author</contrib>
</author>
</authorgroup>
</info>
<refmeta>
<refentrytitle>notify-send</refentrytitle>
<manvolnum>1</manvolnum>
<refmiscinfo class="manual">User Commands</refmiscinfo>
</refmeta>
<refnamediv>
<refname>notify-send</refname>
<refpurpose>a program to send desktop notifications</refpurpose>
</refnamediv>
<refsynopsisdiv>
<cmdsynopsis>
<command>notify-send</command>
<arg choice="opt">
<replaceable>OPTIONS</replaceable>
</arg>
<arg choice="req">
<replaceable>summary</replaceable>
</arg>
<arg choice="opt">
<replaceable>body</replaceable>
</arg>
</cmdsynopsis>
</refsynopsisdiv>
<refsection>
<info><title>Description</title></info>
<para>With <command>notify-send</command> you can send desktop notifications to the user via a notification daemon from the command line. 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>
</refsection>
<refsection>
<info><title>Options</title></info>
<variablelist>
<varlistentry>
<term><option>-?</option>, <option>--help</option></term>
<listitem>
<para>Show help and exit.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><option>-a</option>, <option>--app-name</option>=<replaceable>APP_NAME</replaceable></term>
<listitem>
<para>Specifies the app name for the notification.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><option>-A</option>, <option>--action</option>=[<replaceable>NAME</replaceable>=]<replaceable>Text...</replaceable></term>
<listitem>
<para>Specifies the actions to display to the user. Implies <option>--wait</option> to wait for user input. May be set multiple times. The <replaceable>NAME</replaceable> of the action is output to <literal>stdout</literal>. If <replaceable>NAME</replaceable> is not specified, the numerical index of the option is used (starting with <literal>1</literal>).</para>
</listitem>
</varlistentry>
<varlistentry>
<term><option>-u</option>, <option>--urgency</option>=<replaceable>LEVEL</replaceable></term>
<listitem>
<para>Specifies the urgency level (<literal>low</literal>, <literal>normal</literal>, <literal>critical</literal>).</para>
</listitem>
</varlistentry>
<varlistentry>
<term><option>-t</option>, <option>--expire-time</option>=<replaceable>TIME</replaceable>
</term>
<listitem>
<para>The duration, in milliseconds, for the notification to appear on screen.</para>
<para>Not all implementations use this parameter. GNOME Shell and Notify OSD always ignore it, while Plasma ignores it for notifications with the critical urgency level.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><option>-i</option>, <option>--icon</option>=<replaceable>ICON</replaceable>
</term>
<listitem>
<para>Specifies an icon filename or stock icon to display.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><option>-c</option>, <option>--category</option>=<replaceable>TYPE</replaceable>[,<replaceable>TYPE</replaceable>…]
</term>
<listitem>
<para>Specifies the notification category.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><option>-h</option>, <option>--hint</option>=<replaceable>TYPE</replaceable>:<replaceable>NAME</replaceable>:<replaceable>VALUE</replaceable> </term>
<listitem>
<para>Specifies basic extra data to pass. Valid types are <literal>BOOLEAN</literal>, <literal>INT</literal>, <literal>DOUBLE</literal>, <literal>STRING</literal>, <literal>BYTE</literal> and <literal>VARIANT</literal>.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><option>-p</option>, <option>--print-id</option></term>
<listitem>
<para>Print the notification ID.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><option>-r</option>, <option>--replace-id</option>=<replaceable>REPLACE_ID</replaceable></term>
<listitem>
<para>The ID of the notification to replace.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><option>-w</option>, <option>--wait</option></term>
<listitem>
<para>Wait for the notification to be closed before exiting. If the <option>expire-time</option> is set, it will be used as the maximum waiting time.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><option>-e</option>, <option>--transient</option></term>
<listitem>
<para>Show a transient notification. Transient notifications by-pass the server's persistence capability, if any. And so it won't be preserved until the user acknowledges it.</para>
</listitem>
</varlistentry>
</variablelist>
</refsection>
<refsection>
<info><title>See also</title></info>
<para>The Desktop Notification Spec on <link xlink:href="https://specifications.freedesktop.org/notification-spec/">https://specifications.freedesktop.org/notification-spec/</link>.</para>
</refsection>
</refentry>

83
docs/reference/Makefile.am Normal file
View File

@ -0,0 +1,83 @@
## Process this file with automake to produce Makefile.in
# We require automake 1.6 at least.
AUTOMAKE_OPTIONS = 1.6
# This is a blank Makefile.am for using gtk-doc.
# Copy this to your project's API docs directory and modify the variables to
# suit your project. See the GTK+ Makefiles in gtk+/docs/reference for examples
# of using the various options.
# The name of the module, e.g. 'glib'.
DOC_MODULE=libnotify
# The top-level SGML file. You can change this if you want to.
DOC_MAIN_SGML_FILE=$(DOC_MODULE)-docs.sgml
# The directory containing the source code. Relative to $(srcdir).
# gtk-doc will search all .c & .h files beneath here for inline comments
# documenting the functions and macros.
# e.g. DOC_SOURCE_DIR=../../../gtk
DOC_SOURCE_DIR=../../libnotify
# Extra options to pass to gtkdoc-scangobj. Not normally needed.
SCANGOBJ_OPTIONS=
# Extra options to supply to gtkdoc-scan.
# e.g. SCAN_OPTIONS=--deprecated-guards="GTK_DISABLE_DEPRECATED"
SCAN_OPTIONS=
# Extra options to supply to gtkdoc-mkdb.
# e.g. MKDB_OPTIONS=--sgml-mode --output-format=xml
MKDB_OPTIONS=--sgml-mode --output-format=xml
# Extra options to supply to gtkdoc-mktmpl
# e.g. MKTMPL_OPTIONS=--only-section-tmpl
MKTMPL_OPTIONS=
# Extra options to supply to gtkdoc-fixref. Not normally needed.
# e.g. FIXXREF_OPTIONS=--extra-dir=../gdk-pixbuf/html --extra-dir=../gdk/html
FIXXREF_OPTIONS=
# Used for dependencies. The docs will be rebuilt if any of these change.
# e.g. HFILE_GLOB=$(top_srcdir)/gtk/*.h
# e.g. CFILE_GLOB=$(top_srcdir)/gtk/*.c
HFILE_GLOB=$(top_srcdir)/libnotify/*.h
CFILE_GLOB=$(top_srcdir)/libnotify/*.c
# Header files to ignore when scanning.
# e.g. IGNORE_HFILES=gtkdebug.h gtkintl.h
IGNORE_HFILES= \
notify-enum-types.h \
notify-marshal.h \
internal.h
# Images to copy into HTML directory.
# e.g. HTML_IMAGES=$(top_srcdir)/gtk/stock-icons/stock_about_24.png
HTML_IMAGES=
# Extra SGML files that are included by $(DOC_MAIN_SGML_FILE).
# e.g. content_files=running.sgml building.sgml changes-2.0.sgml
content_files=
# SGML files where gtk-doc abbrevations (#GtkWidget) are expanded
# These files must be listed here *and* in content_files
# e.g. expand_content_files=running.sgml
expand_content_files=
# CFLAGS and LDFLAGS for compiling gtkdoc-scangobj with your library.
# Only needed if you are using gtkdoc-scangobj to dynamically query widget
# signals and properties.
# e.g. INCLUDES=-I$(top_srcdir) -I$(top_builddir) $(GTK_DEBUG_FLAGS)
# e.g. GTKDOC_LIBS=$(top_builddir)/gtk/$(gtktargetlib)
INCLUDES=-I$(top_srcdir) -I$(top_builddir) $(PACKAGE_CFLAGS)
GTKDOC_LIBS=$(PACKAGE_LIBS) $(top_builddir)/libnotify/libnotify.la
# This includes the standard gtk-doc make rules, copied by gtkdocize.
include $(top_srcdir)/gtk-doc.make
# Other files to distribute
# e.g. EXTRA_DIST += version.xml.in
EXTRA_DIST +=
-include $(top_srcdir)/git.mk

16
docs/reference/libnotify-docs.sgml
View File

@ -4,10 +4,6 @@
<book id="index" xmlns:xi="http://www.w3.org/2003/XInclude">
<bookinfo>
<title>Libnotify Reference Manual</title>
<releaseinfo>
The latest version of this documentation can be found on-line at
<ulink role="online-location" url="http://developer.gnome.org/libnotify/unstable/">http://developer.gnome.org/libnotify/unstable/</ulink>.
</releaseinfo>
</bookinfo>
<chapter>
@ -15,16 +11,4 @@
<xi:include href="xml/notify.xml"/>
<xi:include href="xml/notification.xml"/>
</chapter>
<index id="api-index-full">
<title id="index-all">Index</title>
<xi:include href="xml/api-index-full.xml"><xi:fallback /></xi:include>
</index>
<index id="api-index-deprecated" role="deprecated">
<title>Index of deprecated symbols</title>
<xi:include href="xml/api-index-deprecated.xml"><xi:fallback /></xi:include>
</index>
<xi:include href="xml/annotation-glossary.xml"><xi:fallback /></xi:include>
</book>

13
docs/reference/libnotify-sections.txt
View File

@ -4,22 +4,21 @@ NOTIFY_EXPIRES_DEFAULT
NOTIFY_EXPIRES_NEVER
<TITLE>NotifyNotification</TITLE>
NotifyNotification
NotifyClosedReason
NotifyUrgency
NotifyActionCallback
NOTIFY_ACTION_CALLBACK
notify_notification_new
notify_notification_new_with_status_icon
notify_notification_update
notify_notification_attach_to_widget
notify_notification_attach_to_status_icon
notify_notification_set_geometry_hints
notify_notification_show
notify_notification_set_app_name
notify_notification_set_timeout
notify_notification_set_category
notify_notification_set_urgency
notify_notification_set_icon_from_pixbuf
notify_notification_set_image_from_pixbuf
notify_notification_set_hint
notify_notification_set_hint_int32
notify_notification_set_hint_uint32
notify_notification_set_hint_double
notify_notification_set_hint_string
notify_notification_set_hint_byte
@ -28,10 +27,7 @@ notify_notification_clear_hints
notify_notification_add_action
notify_notification_clear_actions
notify_notification_close
notify_notification_get_activation_token
notify_notification_get_closed_reason
<SUBSECTION Standard>
NotifyNotificationPrivate
NOTIFY_NOTIFICATION
NOTIFY_IS_NOTIFICATION
NOTIFY_TYPE_NOTIFICATION
@ -47,7 +43,6 @@ notify_init
notify_uninit
notify_is_initted
notify_get_app_name
notify_set_app_name
notify_get_server_caps
notify_get_server_info
</SECTION>

10
docs/reference/meson.build
View File

@ -1,10 +0,0 @@
gnome.gtkdoc(meson.project_name(),
mode: 'sgml',
main_sgml: meson.project_name() + '-docs.sgml',
src_dir: join_paths(meson.source_root(), meson.project_name()),
dependencies: libnotify_dep,
gobject_typesfile: meson.project_name() + '.types',
ignore_headers: ['notify-enum-types.h', 'notify-marshal.h', 'internal.h'],
scan_args: [ '--deprecated-guards=LIBNOTIFY_DISABLE_DEPRECATED' ],
install: true,
)

14
docs/reference/tmpl/libnotify-docs.sgml Normal file
View File

@ -0,0 +1,14 @@
<?xml version="1.0"?>
<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
"http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd">
<book id="index" xmlns:xi="http://www.w3.org/2003/XInclude">
<bookinfo>
<title>Libnotify Reference Manual</title>
</bookinfo>
<chapter id='libnotify'>
<title>Libnotify</title>
<xi:include href="xml/notify.xml"/>
<xi:include href="xml/notification.xml"/>
</chapter>
</book>

0
docs/reference/tmpl/libnotify-unused.sgml Normal file
View File

327
docs/reference/tmpl/notification.sgml Normal file
View File

@ -0,0 +1,327 @@
<!-- ##### SECTION Title ##### -->
NotifyNotification
<!-- ##### SECTION Short_Description ##### -->
A passive pop-up notification.
<!-- ##### SECTION Long_Description ##### -->
<para>
#NotifyNotification represents a passive pop-up notification. It can
contain summary text, body text, and an icon, as well as hints specifying
how the notification should be presented. The notification is rendered
by a notification daemon, and may present the notification in any number
of ways. As such, there is a clear separation of content and presentation,
and this API enforces that.
</para>
<!-- ##### SECTION See_Also ##### -->
<para>
</para>
<!-- ##### SECTION Stability_Level ##### -->
<!-- ##### SECTION Image ##### -->
<!-- ##### MACRO NOTIFY_EXPIRES_DEFAULT ##### -->
<para>
The default expiration time on a notification.
</para>
<!-- ##### MACRO NOTIFY_EXPIRES_NEVER ##### -->
<para>
The notification never expires. It stays open until closed by the calling API
or the user.
</para>
<!-- ##### STRUCT NotifyNotification ##### -->
<para>
This is an opaque structure representing a notification. This should
not be used directly. Use the accessor functions below.
</para>
<!-- ##### SIGNAL NotifyNotification::closed ##### -->
<para>
</para>
@notifynotification: the object which received the signal.
<!-- ##### ARG NotifyNotification:attach-widget ##### -->
<para>
</para>
<!-- ##### ARG NotifyNotification:body ##### -->
<para>
</para>
<!-- ##### ARG NotifyNotification:closed-reason ##### -->
<para>
</para>
<!-- ##### ARG NotifyNotification:icon-name ##### -->
<para>
</para>
<!-- ##### ARG NotifyNotification:id ##### -->
<para>
</para>
<!-- ##### ARG NotifyNotification:status-icon ##### -->
<para>
</para>
<!-- ##### ARG NotifyNotification:summary ##### -->
<para>
</para>
<!-- ##### ENUM NotifyUrgency ##### -->
<para>
The urgency level of the notification.
</para>
@NOTIFY_URGENCY_LOW:
Low urgency. Used for unimportant notifications.
@NOTIFY_URGENCY_NORMAL:
Normal urgency. Used for most standard notifications.
@NOTIFY_URGENCY_CRITICAL:
Critical urgency. Used for very important notifications.
<!-- ##### USER_FUNCTION NotifyActionCallback ##### -->
<para>
An action callback function.
</para>
@notification:
@action:
@user_data:
<!-- # Unused Parameters # -->
@Param1: The notification.
@Param2: The action ID.
@Param3: User data.
<!-- ##### MACRO NOTIFY_ACTION_CALLBACK ##### -->
<para>
A convenience macro for casting a function to a #NotifyActionCallback. This
is much like G_CALLBACK().
</para>
@func: The function to cast.
<!-- ##### FUNCTION notify_notification_new ##### -->
<para>
</para>
@summary:
@body:
@icon:
@attach:
@Returns:
<!-- ##### FUNCTION notify_notification_new_with_status_icon ##### -->
<para>
</para>
@summary:
@body:
@icon:
@status_icon:
@Returns:
<!-- ##### FUNCTION notify_notification_update ##### -->
<para>
</para>
@notification:
@summary:
@body:
@icon:
@Returns:
<!-- ##### FUNCTION notify_notification_attach_to_widget ##### -->
<para>
</para>
@notification:
@attach:
<!-- ##### FUNCTION notify_notification_attach_to_status_icon ##### -->
<para>
</para>
@notification:
@status_icon:
<!-- ##### FUNCTION notify_notification_set_geometry_hints ##### -->
<para>
</para>
@notification:
@screen:
@x:
@y:
<!-- ##### FUNCTION notify_notification_show ##### -->
<para>
</para>
@notification:
@error:
@Returns:
<!-- ##### FUNCTION notify_notification_set_timeout ##### -->
<para>
</para>
@notification:
@timeout:
<!-- ##### FUNCTION notify_notification_set_category ##### -->
<para>
</para>
@notification:
@category:
<!-- ##### FUNCTION notify_notification_set_urgency ##### -->
<para>
</para>
@notification:
@urgency:
<!-- ##### FUNCTION notify_notification_set_icon_from_pixbuf ##### -->
<para>
</para>
@notification:
@icon:
<!-- ##### FUNCTION notify_notification_set_hint_int32 ##### -->
<para>
</para>
@notification:
@key:
@value:
<!-- ##### FUNCTION notify_notification_set_hint_double ##### -->
<para>
</para>
@notification:
@key:
@value:
<!-- ##### FUNCTION notify_notification_set_hint_string ##### -->
<para>
</para>
@notification:
@key:
@value:
<!-- ##### FUNCTION notify_notification_set_hint_byte ##### -->
<para>
</para>
@notification:
@key:
@value:
<!-- ##### FUNCTION notify_notification_set_hint_byte_array ##### -->
<para>
</para>
@notification:
@key:
@value:
@len:
<!-- ##### FUNCTION notify_notification_clear_hints ##### -->
<para>
</para>
@notification:
<!-- ##### FUNCTION notify_notification_add_action ##### -->
<para>
</para>
@notification:
@action:
@label:
@callback:
@user_data:
@free_func:
<!-- ##### FUNCTION notify_notification_clear_actions ##### -->
<para>
</para>
@notification:
<!-- ##### FUNCTION notify_notification_close ##### -->
<para>
</para>
@notification:
@error:
@Returns:

78
docs/reference/tmpl/notify.sgml Normal file
View File

@ -0,0 +1,78 @@
<!-- ##### SECTION Title ##### -->
notify
<!-- ##### SECTION Short_Description ##### -->
Notification API
<!-- ##### SECTION Long_Description ##### -->
<para>
</para>
<!-- ##### SECTION See_Also ##### -->
<para>
</para>
<!-- ##### SECTION Stability_Level ##### -->
<!-- ##### SECTION Image ##### -->
<!-- ##### FUNCTION notify_init ##### -->
<para>
</para>
@app_name:
@Returns:
<!-- ##### FUNCTION notify_uninit ##### -->
<para>
</para>
@void:
<!-- ##### FUNCTION notify_is_initted ##### -->
<para>
</para>
@void:
@Returns:
<!-- ##### FUNCTION notify_get_app_name ##### -->
<para>
</para>
@void:
@Returns:
<!-- ##### FUNCTION notify_get_server_caps ##### -->
<para>
</para>
@void:
@Returns:
<!-- ##### FUNCTION notify_get_server_info ##### -->
<para>
</para>
@ret_name:
@ret_vendor:
@ret_version:
@ret_spec_version:
@Returns:

2
docs/releases/notification-spec-0.3.xml
View File

@ -1,6 +1,6 @@
<?xml version="1.0"?>
<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
<!DOCTYPE article PUBLIC "-//OASIS/DTD DocBook XML V4.1.2//EN"
"http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd">
<article id="index">

2
docs/releases/notification-spec-0.4.xml
View File

@ -1,6 +1,6 @@
<?xml version="1.0"?>
<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
<!DOCTYPE article PUBLIC "-//OASIS/DTD DocBook XML V4.1.2//EN"
"http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd">
<article id="index">

2
docs/releases/notification-spec-0.6.xml
View File

@ -1,6 +1,6 @@
<?xml version="1.0"?>
<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
<!DOCTYPE article PUBLIC "-//OASIS/DTD DocBook XML V4.1.2//EN"
"http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd">
<article id="index">

2
docs/releases/notification-spec-0.7.xml
View File

@ -1,6 +1,6 @@
<?xml version="1.0"?>
<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
<!DOCTYPE article PUBLIC "-//OASIS/DTD DocBook XML V4.1.2//EN"
"http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd">
<article id="index">

2
docs/releases/notification-spec-0.9.xml
View File

@ -1,5 +1,5 @@
<?xml version="1.0"?>
<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd">
<!DOCTYPE article PUBLIC "-//OASIS/DTD DocBook XML V4.1.2//EN" "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd">
<article id="index">
<articleinfo>
<title>Desktop Notifications Specification</title>

2
docs/releases/notification-spec-1.0.xml
View File

@ -1,5 +1,5 @@
<?xml version="1.0"?>
<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd">
<!DOCTYPE article PUBLIC "-//OASIS/DTD DocBook XML V4.1.2//EN" "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd">
<article id="index">
<articleinfo>
<title>Desktop Notifications Specification</title>

184
git.mk Normal file
View File

@ -0,0 +1,184 @@
# git.mk
#
# Copyright 2009, Red Hat, Inc.
# Written by Behdad Esfahbod
#
# Copying and distribution of this file, with or without modification,
# are permitted in any medium without royalty provided the copyright
# notice and this notice are preserved.
#
# The canonical source for this file is pango/git.mk, or whereever the
# header of pango/git.mk suggests in the future.
#
# To use in your project, import this file in your git repo's toplevel,
# then do "make -f git.mk". This modifies all Makefile.am files in
# your project to include git.mk.
#
# This enables automatic .gitignore generation. If you need to ignore
# more files, add them to the GITIGNOREFILES variable in your Makefile.am.
# But think twice before doing that. If a file has to be in .gitignore,
# chances are very high that it's a generated file and should be in one
# of MOSTLYCLEANFILES, CLEANFILES, DISTCLEANFILES, or MAINTAINERCLEANFILES.
#
# The only case that you need to manually add a file to GITIGNOREFILES is
# when remove files in one of mostlyclean-local, clean-local, distclean-local,
# or maintainer-clean-local.
#
# Note that for files like editor backup, etc, there are better places to
# ignore them. See "man gitignore".
#
# If "make maintainer-clean" removes the files but they are not recognized
# by this script (that is, if "git status" shows untracked files still), send
# me the output of "git status" as well as your Makefile.am and Makefile for
# the directories involved.
#
# For a list of toplevel files that should be in MAINTAINERCLEANFILES, see
# pango/Makefile.am.
#
# Don't EXTRA_DIST this file. It is supposed to only live in git clones,
# not tarballs. It serves no useful purpose in tarballs and clutters the
# build dir.
#
# This file knows how to handle autoconf, automake, libtool, gtk-doc,
# gnome-doc-utils, intltool.
#
#
# KNOWN ISSUES:
#
# - Recursive configure doesn't work as $(top_srcdir)/git.mk inside the
# submodule doesn't find us. If you have configure.{in,ac} files in
# subdirs, add a proxy git.mk file in those dirs that simply does:
# "include $(top_srcdir)/../git.mk". Add more ..'s to your taste.
# And add those files to git. See vte/gnome-pty-helper/git.mk for
# example.
#
git-all: git-mk-install
git-mk-install:
@echo Installing git makefile
@any_failed=; find $(top_srcdir) -name Makefile.am | while read x; do \
if grep 'include .*/git.mk' $$x >/dev/null; then \
echo $$x already includes git.mk; \
else \
failed=; \
echo "Updating $$x"; \
{ cat $$x; \
echo ''; \
echo '-include $$(top_srcdir)/git.mk'; \
} > $$x.tmp || failed=1; \
if test x$$failed = x; then \
mv $$x.tmp $$x || failed=1; \
fi; \
if test x$$failed = x; then : else \
echo Failed updating $$x; >&2 \
any_failed=1; \
fi; \
fi; done; test -z "$$any_failed"
.PHONY: git-all git-mk-install
### .gitignore generation
$(srcdir)/.gitignore: Makefile.am $(top_srcdir)/git.mk
$(AM_V_GEN) \
{ \
if test "x$(DOC_MODULE)" = x -o "x$(DOC_MAIN_SGML_FILE)" = x; then :; else \
for x in \
$(DOC_MODULE)-decl-list.txt \
$(DOC_MODULE)-decl.txt \
tmpl/$(DOC_MODULE)-unused.sgml \
"tmpl/*.bak" \
xml html \
; do echo /$$x; done; \
fi; \
if test "x$(DOC_MODULE)" = x -o "x$(DOC_LINGUAS)" = x; then :; else \
for x in \
$(_DOC_C_DOCS) \
$(_DOC_LC_DOCS) \
$(_DOC_OMF_ALL) \
$(_DOC_DSK_ALL) \
$(_DOC_HTML_ALL) \
$(_DOC_POFILES) \
"*/.xml2po.mo" \
"*/*.omf.out" \
; do echo /$$x; done; \
fi; \
if test -f $(srcdir)/po/Makefile.in.in; then \
for x in \
po/Makefile.in.in \
po/Makefile.in \
po/Makefile \
po/POTFILES \
po/stamp-it \
po/.intltool-merge-cache \
"po/*.gmo" \
"po/*.mo" \
po/$(GETTEXT_PACKAGE).pot \
intltool-extract.in \
intltool-merge.in \
intltool-update.in \
; do echo /$$x; done; \
fi; \
if test -f $(srcdir)/configure; then \
for x in \
autom4te.cache \
configure \
config.h \
stamp-h1 \
libtool \
config.lt \
; do echo /$$x; done; \
fi; \
for x in \
.gitignore \
$(GITIGNOREFILES) \
$(CLEANFILES) \
$(PROGRAMS) \
$(check_PROGRAMS) \
$(EXTRA_PROGRAMS) \
$(LTLIBRARIES) \
so_locations \
.libs _libs \
$(MOSTLYCLEANFILES) \
"*.$(OBJEXT)" \
"*.lo" \
$(DISTCLEANFILES) \
$(am__CONFIG_DISTCLEAN_FILES) \
$(CONFIG_CLEAN_FILES) \
TAGS ID GTAGS GRTAGS GSYMS GPATH tags \
"*.tab.c" \
$(MAINTAINERCLEANFILES) \
$(BUILT_SOURCES) \
$(DEPDIR) \
Makefile \
Makefile.in \
"*.orig" \
"*.rej" \
"*.bak" \
"*~" \
".*.sw[nop]" \
; do echo /$$x; done; \
} | \
sed "s@^/`echo "$(srcdir)" | sed 's/\(.\)/[\1]/g'`/@/@" | \
sed 's@/[.]/@/@g' | \
LC_ALL=C sort | uniq > $@.tmp && \
mv $@.tmp $@;
all: $(srcdir)/.gitignore gitignore-recurse-maybe
gitignore-recurse-maybe:
@if test "x$(SUBDIRS)" = "x$(DIST_SUBDIRS)"; then :; else \
$(MAKE) $(AM_MAKEFLAGS) gitignore-recurse; \
fi;
gitignore-recurse:
@list='$(DIST_SUBDIRS)'; for subdir in $$list; do \
test "$$subdir" = . || (cd $$subdir && $(MAKE) $(AM_MAKEFLAGS) .gitignore gitignore-recurse || echo "Skipping $$subdir"); \
done
gitignore: $(srcdir)/.gitignore gitignore-recurse
maintainer-clean: gitignore-clean
gitignore-clean:
-rm -f $(srcdir)/.gitignore
.PHONY: gitignore-clean gitignore gitignore-recurse gitignore-recurse-maybe

17
libnotify.doap
View File

@ -5,24 +5,19 @@
xmlns="http://usefulinc.com/ns/doap#">
<name xml:lang="en">Desktop notification library</name>
<shortname>libnotify</shortname>
<category rdf:resource="http://api.gnome.org/doap-extensions#core" />
<programming-language>C</programming-language>
<shortdesc xml:lang="en">libnotify is a library for sending desktop notifications</shortdesc>
<description>Library to send desktop notifications that follows the FDO
specifications:
https://gitlab.freedesktop.org/xdg/xdg-specs/-/blob/master/notification/notification-spec.xml</description>
<maintainer>
<foaf:Person>
<foaf:name>Marco Trevisan</foaf:name>
<foaf:mbox rdf:resource="mailto:mail@3v1n0.net" />
<gnome:userid>marcotrevi</gnome:userid>
<foaf:name>Christian Hammond</foaf:name>
<foaf:mbox rdf:resource="mailto:chipx86@chipx86.com" />
<gnome:userid>chipx86</gnome:userid>
</foaf:Person>
</maintainer>
<maintainer>
<foaf:Person>
<foaf:name>Logan Rathbone</foaf:name>
<foaf:mbox rdf:resource="mailto:poprocks@gmail.com" />
<gnome:userid>larathbone</gnome:userid>
<foaf:name>William Jon McCann</foaf:name>
<foaf:mbox rdf:resource="mailto:william.jon.mccann@gmail.com" />
<gnome:userid>mccann</gnome:userid>
</foaf:Person>
</maintainer>
</Project>

12
libnotify.pc.in Normal file
View File

@ -0,0 +1,12 @@
prefix=@prefix@
exec_prefix=@exec_prefix@
libdir=@libdir@
includedir=@includedir@
Name: libnotify
Description: Notifications Library
Version: @VERSION@
Requires: @pkg_modules@
Libs: -L${libdir} -lnotify
Cflags: -I${includedir}

92
libnotify/Makefile.am Normal file
View File

@ -0,0 +1,92 @@
notifyincdir = $(includedir)/libnotify
MARSHAL_PREFIX = notify_marshal
MARSHAL_FILE = notify-marshal
ENUM_FILE = notify-enum-types
lib_LTLIBRARIES = libnotify.la
notify_headers = \
notify.h \
notify-features.h \
notification.h
notifyinc_HEADERS = \
$(notify_headers) \
$(ENUM_FILE).h
noinst_HEADERS = \
notify-marshal.h \
internal.h
BUILT_SOURCES = \
$(ENUM_FILE).h \
$(ENUM_FILE).c \
notify-marshal.c \
notify-marshal.h
libnotify_la_SOURCES = \
notify.c \
notification.c \
notify-enum-types.c \
notify-marshal.c
libnotify_la_LIBADD = \
$(PACKAGE_LIBS)
libnotify_la_LDFLAGS = \
-version-info $(LT_CURRENT):$(LT_REVISION):$(LT_AGE)
notify-marshal.h: notify-marshal.list
$(AM_V_GEN) $(GLIB_GENMARSHAL) --prefix=$(MARSHAL_PREFIX) notify-marshal.list \
--header > notify-marshal.h
notify-marshal.c: notify-marshal.list
$(AM_V_GEN) $(GLIB_GENMARSHAL) --prefix=$(MARSHAL_PREFIX) notify-marshal.list \
--header --body > notify-marshal.c
$(ENUM_FILE).h: s-enum-types-h
@true
s-enum-types-h: $(notify_headers) Makefile
$(AM_V_GEN) ( cd $(srcdir) && glib-mkenums \
--fhead "#ifndef _NOTIFY_ENUM_TYPES_H_\n#define _NOTIFY_ENUM_TYPES_H_\n\n#include <glib-object.h>\n\nG_BEGIN_DECLS\n" \
--fprod "/* enumerations from \"@filename@\" */\n" \
--vhead "GType @enum_name@_get_type(void);\n#define NOTIFY_TYPE_@ENUMSHORT@ (@enum_name@_get_type())\n" \
--ftail "G_END_DECLS\n\n#endif /* _NOTIFY_ENUM_TYPES_H_ */" \
$(notify_headers) ) > tmp-$(ENUM_FILE).h \
&& (cmp -s tmp-$(ENUM_FILE).h $(ENUM_FILE).h || cp tmp-$(ENUM_FILE).h $(ENUM_FILE).h ) \
&& rm -f tmp-$(ENUM_FILE).h \
&& echo timestamp > $(@F)
$(ENUM_FILE).c: s-enum-types-c
@true
s-enum-types-c: $(notify_headers) Makefile
$(AM_V_GEN) ( cd $(srcdir) && glib-mkenums \
--fhead "#include <libnotify/notify.h>" \
--fprod "\n/* enumerations from \"@filename@\" */" \
--vhead "GType\n@enum_name@_get_type (void)\n{\n static GType etype = 0;\n if (etype == 0) {\n static const G@Type@Value values[] = {" \
--vprod " { @VALUENAME@, \"@VALUENAME@\", \"@valuenick@\" }," \
--vtail " { 0, NULL, NULL }\n };\n etype = g_@type@_register_static (\"@EnumName@\", values);\n }\n return etype;\n}\n" \
$(notify_headers) ) > tmp-$(ENUM_FILE).c \
&& (cmp -s tmp-$(ENUM_FILE).c $(ENUM_FILE).c || cp tmp-$(ENUM_FILE).c $(ENUM_FILE).c ) \
&& rm -f tmp-$(ENUM_FILE).c \
&& echo timestamp > $(@F)
EXTRA_DIST = \
notify-marshal.list \
$(ENUM_FILE).h
CLEANFILES = \
notify-marshal.c \
notify-marshal.h \
$(ENUM_FILE).c \
$(ENUM_FILE).h \
s-enum-types-c \
s-enum-types-h
INCLUDES = \
-I$(top_srcdir) \
-DG_LOG_DOMAIN=\"libnotify\" \
$(PACKAGE_CFLAGS)
-include $(top_srcdir)/git.mk

20
libnotify/internal.h
View File

@ -22,17 +22,19 @@
#ifndef _LIBNOTIFY_INTERNAL_H_
#define _LIBNOTIFY_INTERNAL_H_
#include "config.h"
#include <dbus/dbus.h>
#include <dbus/dbus-glib.h>
#define NOTIFY_DBUS_NAME "org.freedesktop.Notifications"
#define NOTIFY_DBUS_CORE_INTERFACE "org.freedesktop.Notifications"
#define NOTIFY_DBUS_CORE_OBJECT "/org/freedesktop/Notifications"
#define NOTIFY_PORTAL_DBUS_NAME "org.freedesktop.portal.Desktop"
#define NOTIFY_PORTAL_DBUS_CORE_INTERFACE "org.freedesktop.portal.Notification"
#define NOTIFY_PORTAL_DBUS_CORE_OBJECT "/org/freedesktop/portal/desktop"
G_BEGIN_DECLS
GDBusProxy * _notify_get_proxy (GError **error);
DBusGConnection * _notify_get_dbus_g_conn (void);
DBusGProxy * _notify_get_g_proxy (void);
void _notify_cache_add_notification (NotifyNotification *n);
void _notify_cache_remove_notification (NotifyNotification *n);
@ -40,14 +42,6 @@ gint _notify_notification_get_timeout (const NotifyNotific
gboolean _notify_notification_has_nondefault_actions (const NotifyNotification *n);
gboolean _notify_check_spec_version (int major, int minor);
const char * _notify_get_snap_name (void);
const char * _notify_get_snap_path (void);
const char * _notify_get_snap_app (void);
const char * _notify_get_flatpak_app (void);
gboolean _notify_uses_portal_notifications (void);
G_END_DECLS
#endif /* _LIBNOTIFY_INTERNAL_H_ */

6
libnotify/libnotify.map
View File

@ -1,6 +0,0 @@
{
global:
notify_*;
local:
*;
};

86
libnotify/meson.build
View File

@ -1,86 +0,0 @@
libnotify_includesubdir = meson.project_name()
libnotify_includedir = join_paths(includedir, libnotify_includesubdir)
headers = [
'notify.h',
'notification.h',
]
sources = [
'notify.c',
'notification.c',
]
features_data = configuration_data()
features_data.set('LIBNOTIFY_MAJOR_VERSION', VERSION_ARRAY[0])
features_data.set('LIBNOTIFY_MINOR_VERSION', VERSION_ARRAY[1])
features_data.set('LIBNOTIFY_MICRO_VERSION', VERSION_ARRAY[2])
headers += configure_file(
input: 'notify-features.h.in',
output: 'notify-features.h',
configuration: features_data)
enum_types = gnome.mkenums_simple('@0@-enum-types'.format(LIBNAME),
sources : headers,
install_header: true,
install_dir: libnotify_includedir
)
marshal = gnome.genmarshal('@0@-marshal'.format(LIBNAME),
prefix: '@0@_marshal'.format(LIBNAME),
sources: '@0@-marshal.list'.format(LIBNAME),
)
libnotify_cflags = [
'-DG_LOG_DOMAIN="libnotify"',
]
mapfile = meson.project_name() + '.map'
libnotify_ldflags = cc.get_supported_link_arguments([
'-Wl,--version-script,'+join_paths(meson.current_source_dir(), mapfile),
])
notify_dep = declare_dependency(
include_directories: default_includes,
dependencies: libnotify_deps,
compile_args: libnotify_cflags,
sources: headers + [enum_types[1]] + [marshal[1]],
link_args: libnotify_ldflags,
)
libnotify_lib = shared_library(LIBNAME,
dependencies: notify_dep,
sources: sources + enum_types + marshal,
version: '@0@.@1@.@2@'.format(LT_CURRENT, LT_REVISION, LT_AGE),
soversion: LT_CURRENT,
install: true,
)
libnotify_dep = declare_dependency(
dependencies: notify_dep,
link_with: libnotify_lib
)
pkgconfig.generate(libnotify_lib,
name: meson.project_name(),
libraries: libnotify_deps,
description: 'Notifications Library',
)
introspection = get_option('introspection')
g_ir_scanner = find_program('g-ir-scanner', required: introspection.enabled())
if g_ir_scanner.found() and not introspection.disabled()
gnome.generate_gir(libnotify_lib,
sources: headers + sources + enum_types,
namespace: 'Notify',
nsversion: MODULE_VERSION,
export_packages: meson.project_name(),
includes: ['GLib-2.0', 'GdkPixbuf-2.0'],
extra_args: '--c-include=@0@/@1@.h'.format(meson.project_name(), LIBNAME),
install: true
)
endif
install_headers(headers, subdir: libnotify_includesubdir)

1520
libnotify/notification.c
View File

File diff suppressed because it is too large Load Diff

104
libnotify/notification.h
View File

@ -25,23 +25,11 @@
#include <glib.h>
#include <glib-object.h>
#include <gdk-pixbuf/gdk-pixbuf.h>
#include <gtk/gtk.h>
G_BEGIN_DECLS
/**
* NOTIFY_EXPIRES_DEFAULT:
*
* The default expiration time on a notification.
*/
#define NOTIFY_EXPIRES_DEFAULT -1
/**
* NOTIFY_EXPIRES_NEVER:
*
* The notification never expires. It stays open until closed by the calling API
* or the user.
*/
#define NOTIFY_EXPIRES_NEVER 0
#define NOTIFY_TYPE_NOTIFICATION (notify_notification_get_type ())
@ -55,16 +43,9 @@ typedef struct _NotifyNotification NotifyNotification;
typedef struct _NotifyNotificationClass NotifyNotificationClass;
typedef struct _NotifyNotificationPrivate NotifyNotificationPrivate;
/**
* NotifyNotification:
*
* A passive pop-up notification.
*/
struct _NotifyNotification
{
/*< private >*/
GObject parent_object;
NotifyNotificationPrivate *priv;
};
@ -76,14 +57,8 @@ struct _NotifyNotificationClass
void (*closed) (NotifyNotification *notification);
};
/**
* NotifyUrgency:
* @NOTIFY_URGENCY_LOW: Low urgency. Used for unimportant notifications.
* @NOTIFY_URGENCY_NORMAL: Normal urgency. Used for most standard notifications.
* @NOTIFY_URGENCY_CRITICAL: Critical urgency. Used for very important notifications.
*
* The urgency level of the notification.
/*
* Notification urgency levels.
*/
typedef enum
{
@ -93,61 +68,40 @@ typedef enum
} NotifyUrgency;
/**
* NotifyClosedReason:
* @NOTIFY_CLOSED_REASON_UNSET: Notification not closed.
* @NOTIFY_CLOSED_REASON_EXPIRED: Timeout has expired.
* @NOTIFY_CLOSED_REASON_DISMISSED: It has been dismissed by the user.
* @NOTIFY_CLOSED_REASON_API_REQUEST: It has been closed by a call to
* notify_notification_close().
* @NOTIFY_CLOSED_REASON_UNDEFIEND: Closed by undefined/reserved reasons.
*
* The reason for which the notification has been closed.
*
* Since: 0.8.0
*/
typedef enum
{
NOTIFY_CLOSED_REASON_UNSET = -1,
NOTIFY_CLOSED_REASON_EXPIRED = 1,
NOTIFY_CLOSED_REASON_DISMISSED = 2,
NOTIFY_CLOSED_REASON_API_REQUEST = 3,
NOTIFY_CLOSED_REASON_UNDEFIEND = 4,
} NotifyClosedReason;
/**
* NotifyActionCallback:
* @notification: a #NotifyActionCallback notification
* @action: (transfer none): The activated action name
* @user_data: (nullable) (transfer none): User provided data
*
* An action callback function.
*/
typedef void (*NotifyActionCallback) (NotifyNotification *notification,
char *action,
gpointer user_data);
/**
* NOTIFY_ACTION_CALLBACK:
* @func: The function to cast.
*
* A convenience macro for casting a function to a #NotifyActionCallback. This
* is much like G_CALLBACK().
*/
#define NOTIFY_ACTION_CALLBACK(func) ((NotifyActionCallback)(func))
GType notify_notification_get_type (void);
NotifyNotification *notify_notification_new (const char *summary,
const char *body,
const char *icon);
const char *icon,
GtkWidget *attach);
NotifyNotification *notify_notification_new_with_status_icon (const char *summary,
const char *body,
const char *icon,
GtkStatusIcon *status_icon);
gboolean notify_notification_update (NotifyNotification *notification,
const char *summary,
const char *body,
const char *icon);
void notify_notification_attach_to_widget (NotifyNotification *notification,
GtkWidget *attach);
void notify_notification_attach_to_status_icon (NotifyNotification *notification,
GtkStatusIcon *status_icon);
void notify_notification_set_geometry_hints (NotifyNotification *notification,
GdkScreen *screen,
gint x,
gint y);
gboolean notify_notification_show (NotifyNotification *notification,
GError **error);
@ -160,12 +114,10 @@ void notify_notification_set_category (NotifyNotificatio
void notify_notification_set_urgency (NotifyNotification *notification,
NotifyUrgency urgency);
void notify_notification_set_image_from_pixbuf (NotifyNotification *notification,
GdkPixbuf *pixbuf);
#ifndef LIBNOTIFY_DISABLE_DEPRECATED
void notify_notification_set_icon_from_pixbuf (NotifyNotification *notification,
GdkPixbuf *icon);
void notify_notification_set_image_from_pixbuf (NotifyNotification *notification,
GdkPixbuf *image);
void notify_notification_set_hint_int32 (NotifyNotification *notification,
const char *key,
@ -190,14 +142,6 @@ void notify_notification_set_hint_byte_array (NotifyNotificatio
const char *key,
const guchar *value,
gsize len);
#endif
void notify_notification_set_hint (NotifyNotification *notification,
const char *key,
GVariant *value);
void notify_notification_set_app_name (NotifyNotification *notification,
const char *app_name);
void notify_notification_clear_hints (NotifyNotification *notification);
@ -208,8 +152,6 @@ void notify_notification_add_action (NotifyNotificatio
gpointer user_data,
GFreeFunc free_func);
const char *notify_notification_get_activation_token (NotifyNotification *notification);
void notify_notification_clear_actions (NotifyNotification *notification);
gboolean notify_notification_close (NotifyNotification *notification,
GError **error);

19
libnotify/notify-features.h.in
View File

@ -2,20 +2,21 @@
*
* Copyright (C) 2010 Red Hat, Inc.
*
* This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Lesser General Public
* License as published by the Free Software Foundation; either
* version 2.1 of the License, or (at your option) any later version.
* This program is free software; you can redistribute it and/or
* modify it under the terms of the GNU General Public License as
* published by the Free Software Foundation; either version 2 of the
* License, or (at your option) any later version.
*
* This library is distributed in the hope that it will be useful,
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Lesser General Public License for more details.
* General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public
* License along with this library; if not, write to the
* You should have received a copy of the GNU General Public
* License along with this program; if not, write to the
* Free Software Foundation, Inc., 59 Temple Place - Suite 330,
* Boston, MA 02111-1307, USA.
* Boston, MA 02111-1307, USA.
*
*/
#ifndef __NOTIFY_VERSION_H__

615
libnotify/notify.c
View File

@ -3,7 +3,6 @@
* Copyright (C) 2004-2006 Christian Hammond <chipx86@chipx86.com>
* Copyright (C) 2004-2006 Mike Hearn <mike@navi.cx>
* Copyright (C) 2010 Red Hat, Inc.
* Copyright © 2010 Christian Persch
*
* This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Lesser General Public
@ -28,29 +27,17 @@
#include <stdarg.h>
#include <unistd.h>
#include <glib.h>
#include <gio/gio.h>
#include "notify.h"
#include "internal.h"
#include "notify-marshal.h"
/**
* SECTION:notify
* @Short_description: Notification API
* @Title: notify
*/
static gboolean _initted = FALSE;
static char *_app_name = NULL;
static char *_snap_name = NULL;
static char *_snap_app = NULL;
static char *_flatpak_app = NULL;
static GDBusProxy *_proxy = NULL;
static DBusGProxy *_proxy = NULL;
static DBusGConnection *_dbus_gconn = NULL;
static GList *_active_notifications = NULL;
static int _spec_version_major = 0;
static int _spec_version_minor = 0;
static int _portal_version = 0;
gboolean
_notify_check_spec_version (int major,
@ -64,72 +51,11 @@ _notify_check_spec_version (int major,
}
static gboolean
_notify_get_server_info (char **ret_name,
char **ret_vendor,
char **ret_version,
char **ret_spec_version,
GError **error)
{
GDBusProxy *proxy;
GVariant *result;
proxy = _notify_get_proxy (error);
if (proxy == NULL) {
return FALSE;
}
if (_notify_uses_portal_notifications ()) {
if (ret_name) {
*ret_name = g_strdup ("Portal Notification");
}
if (ret_vendor) {
*ret_vendor = g_strdup ("Freedesktop");
}
if (ret_version) {
*ret_version = g_strdup_printf ("%u", _portal_version);
}
if (ret_spec_version) {
*ret_spec_version = g_strdup ("1.2");
}
return TRUE;
}
result = g_dbus_proxy_call_sync (proxy,
"GetServerInformation",
g_variant_new ("()"),
G_DBUS_CALL_FLAGS_NONE,
-1 /* FIXME shorter timeout? */,
NULL,
error);
if (result == NULL) {
return FALSE;
}
if (!g_variant_is_of_type (result, G_VARIANT_TYPE ("(ssss)"))) {
g_variant_unref (result);
g_set_error (error, G_DBUS_ERROR, G_DBUS_ERROR_INVALID_ARGS,
"Unexpected reply type");
return FALSE;
}
g_variant_get (result, "(ssss)",
ret_name,
ret_vendor,
ret_version,
ret_spec_version);
g_variant_unref (result);
return TRUE;
}
static gboolean
_notify_update_spec_version (GError **error)
_notify_update_spec_version (void)
{
char *spec_version;
if (!_notify_get_server_info (NULL, NULL, NULL, &spec_version, error)) {
if (!notify_get_server_info (NULL, NULL, NULL, &spec_version)) {
return FALSE;
}
@ -143,290 +69,32 @@ _notify_update_spec_version (GError **error)
return TRUE;
}
static gboolean
set_app_name (const char *app_name)
{
g_return_val_if_fail (app_name != NULL, FALSE);
g_return_val_if_fail (*app_name != '\0', FALSE);
g_free (_app_name);
_app_name = g_strdup (app_name);
return TRUE;
}
/**
* notify_set_app_name:
* @app_name: The name of the application
*
* Sets the application name.
*
*/
void
notify_set_app_name (const char *app_name)
{
set_app_name (app_name);
}
/**
* notify_init:
* @app_name: (nullable): The name of the application initializing libnotify.
* @app_name: The name of the application initializing libnotify.
*
* Initialized libnotify. This must be called before any other functions.
*
* Starting from 0.8, if the provided @app_name is %NULL, libnotify will
* try to figure it out from the running application.
* Before it was not allowed, and was causing libnotify not to be initialized.
*
* Returns: %TRUE if successful, or %FALSE on error.
*/
gboolean
notify_init (const char *app_name)
{
g_return_val_if_fail (app_name != NULL, FALSE);
g_return_val_if_fail (*app_name != '\0', FALSE);
if (_initted)
return TRUE;
if (app_name == NULL) {
GApplication *application;
_app_name = g_strdup (app_name);
app_name = _notify_get_snap_app ();
if (app_name == NULL) {
app_name = _notify_get_flatpak_app ();
}
if (app_name == NULL &&
(application = g_application_get_default ())) {
app_name = g_application_get_application_id (application);
}
}
if (!set_app_name (app_name)) {
return FALSE;
}
g_type_init ();
_initted = TRUE;
return TRUE;
}
static void
_initialize_snap_names (void)
{
gchar *cgroup_contents = NULL;
gchar *found_snap_name = NULL;
gchar **lines;
gint i;
if (!g_file_get_contents ("/proc/self/cgroup", &cgroup_contents,
NULL, NULL)) {
g_free (cgroup_contents);
return;
}
lines = g_strsplit (cgroup_contents, "\n", -1);
g_free (cgroup_contents);
for (i = 0; lines[i]; ++i) {
gchar **parts = g_strsplit (lines[i], ":", 3);
gchar *basename;
gchar **ns;
guint ns_length;
if (g_strv_length (parts) != 3) {
g_strfreev (parts);
continue;
}
basename = g_path_get_basename (parts[2]);
g_strfreev (parts);
if (!basename) {
continue;
}
ns = g_strsplit (basename, ".", -1);
ns_length = g_strv_length (ns);
g_free (basename);
if (ns_length < 2 || !g_str_equal (ns[0], "snap")) {
g_strfreev (ns);
continue;
}
if (_snap_name == NULL) {
g_free (found_snap_name);
found_snap_name = g_strdup (ns[1]);
}
if (ns_length < 3) {
g_strfreev (ns);
continue;
}
if (_snap_name == NULL) {
_snap_name = found_snap_name;
found_snap_name = NULL;
g_debug ("SNAP name: %s", _snap_name);
}
if (g_str_equal (ns[1], _snap_name)) {
_snap_app = g_strdup (ns[2]);
g_strfreev (ns);
break;
}
g_strfreev (ns);
}
if (_snap_name == NULL && found_snap_name != NULL) {
_snap_name = found_snap_name;
found_snap_name = NULL;
g_debug ("SNAP name: %s", _snap_name);
}
if (_snap_app == NULL) {
_snap_app = g_strdup (_snap_name);
}
g_debug ("SNAP app: %s", _snap_app);
g_strfreev (lines);
g_free (found_snap_name);
}
const char *
_notify_get_snap_path (void)
{
static const char *snap_path = NULL;
static gsize snap_path_set = FALSE;
if (g_once_init_enter (&snap_path_set)) {
snap_path = g_getenv ("SNAP");
if (!snap_path || *snap_path == '\0' ||
!strchr (snap_path, G_DIR_SEPARATOR)) {
snap_path = NULL;
} else {
g_debug ("SNAP path: %s", snap_path);
}
g_once_init_leave (&snap_path_set, TRUE);
}
return snap_path;
}
const char *
_notify_get_snap_name (void)
{
static gsize snap_name_set = FALSE;
if (g_once_init_enter (&snap_name_set)) {
if (!_snap_name) {
const char *snap_name_env = g_getenv ("SNAP_NAME");
if (!snap_name_env || *snap_name_env == '\0')
snap_name_env = NULL;
_snap_name = g_strdup (snap_name_env);
g_debug ("SNAP name: %s", _snap_name);
}
g_once_init_leave (&snap_name_set, TRUE);
}
return _snap_name;
}
const char *
_notify_get_snap_app (void)
{
static gsize snap_app_set = FALSE;
if (g_once_init_enter (&snap_app_set)) {
_initialize_snap_names ();
g_once_init_leave (&snap_app_set, TRUE);
}
return _snap_app;
}
const char *
_notify_get_flatpak_app (void)
{
static gsize flatpak_app_set = FALSE;
if (g_once_init_enter (&flatpak_app_set)) {
GKeyFile *info = g_key_file_new ();
if (g_key_file_load_from_file (info, "/.flatpak-info",
G_KEY_FILE_NONE, NULL)) {
const char *group = "Application";
if (g_key_file_has_group (info, "Runtime")) {
group = "Runtime";
}
_flatpak_app = g_key_file_get_string (info, group,
"name", NULL);
}
g_key_file_free (info);
g_once_init_leave (&flatpak_app_set, TRUE);
}
return _flatpak_app;
}
static gboolean
_notify_is_running_under_flatpak (void)
{
return !!_notify_get_flatpak_app ();
}
static gboolean
_notify_is_running_under_snap (void)
{
return !!_notify_get_snap_app ();
}
static gboolean
_notify_is_running_in_sandbox (void)
{
static gsize use_portal = 0;
enum {
IGNORE_PORTAL = 1,
TRY_USE_PORTAL = 2,
FORCE_PORTAL = 3
};
if (g_once_init_enter (&use_portal)) {
if (G_UNLIKELY (g_getenv ("NOTIFY_IGNORE_PORTAL"))) {
g_once_init_leave (&use_portal, IGNORE_PORTAL);
} else if (G_UNLIKELY (g_getenv ("NOTIFY_FORCE_PORTAL"))) {
g_once_init_leave (&use_portal, FORCE_PORTAL);
} else {
g_once_init_leave (&use_portal, TRY_USE_PORTAL);
}
}
if (use_portal == IGNORE_PORTAL) {
return FALSE;
}
return use_portal == FORCE_PORTAL ||
_notify_is_running_under_flatpak () ||
_notify_is_running_under_snap ();
}
gboolean
_notify_uses_portal_notifications (void)
{
return _portal_version != 0;
}
/**
* notify_get_app_name:
*
@ -473,18 +141,8 @@ notify_uninit (void)
if (_proxy != NULL) {
g_object_unref (_proxy);
_proxy = NULL;
}
g_free (_snap_name);
_snap_name = NULL;
g_free (_snap_app);
_snap_app = NULL;
g_free (_flatpak_app);
_flatpak_app = NULL;
_initted = FALSE;
}
@ -501,165 +159,136 @@ notify_is_initted (void)
return _initted;
}
GDBusProxy *
_get_portal_proxy (GError **error)
DBusGConnection *
_notify_get_dbus_g_conn (void)
{
GError *local_error = NULL;
GDBusProxy *proxy;
GVariant *res;
proxy = g_dbus_proxy_new_for_bus_sync (G_BUS_TYPE_SESSION,
G_DBUS_PROXY_FLAGS_NONE,
NULL,
NOTIFY_PORTAL_DBUS_NAME,
NOTIFY_PORTAL_DBUS_CORE_OBJECT,
NOTIFY_PORTAL_DBUS_CORE_INTERFACE,
NULL,
&local_error);
if (proxy == NULL) {
g_debug ("Failed to get portal proxy: %s", local_error->message);
g_clear_error (&local_error);
return NULL;
}
res = g_dbus_proxy_get_cached_property (proxy, "version");
if (!res) {
g_object_unref (proxy);
return NULL;
}
_portal_version = g_variant_get_uint32 (res);
g_assert (_portal_version > 0);
g_warning ("Running in confined mode, using Portal notifications. "
"Some features and hints won't be supported");
g_variant_unref (res);
return proxy;
return _dbus_gconn;
}
/*
* _notify_get_proxy:
* @error: (allow-none): a location to store a #GError, or %NULL
*
* Synchronously creates the #GDBusProxy for the notification service,
* and caches the result.
*
* Returns: the #GDBusProxy for the notification service, or %NULL on error
*/
GDBusProxy *
_notify_get_proxy (GError **error)
static void
on_proxy_destroy (DBusGProxy *proxy,
gpointer data)
{
_proxy = NULL;
}
DBusGProxy *
_notify_get_g_proxy (void)
{
GError *error;
DBusGConnection *bus;
if (_proxy != NULL)
return _proxy;
if (_notify_is_running_in_sandbox ()) {
_proxy = _get_portal_proxy (error);
if (_proxy != NULL) {
goto out;
}
}
_proxy = g_dbus_proxy_new_for_bus_sync (G_BUS_TYPE_SESSION,
G_DBUS_PROXY_FLAGS_DO_NOT_LOAD_PROPERTIES,
NULL,
NOTIFY_DBUS_NAME,
NOTIFY_DBUS_CORE_OBJECT,
NOTIFY_DBUS_CORE_INTERFACE,
NULL,
error);
out:
if (_proxy == NULL) {
/* lazily initialize D-Bus connection */
error = NULL;
bus = dbus_g_bus_get (DBUS_BUS_SESSION, &error);
if (error != NULL) {
g_error_free (error);
return NULL;
}
if (!_notify_update_spec_version (error)) {
g_object_unref (_proxy);
_proxy = NULL;
_proxy = dbus_g_proxy_new_for_name (bus,
NOTIFY_DBUS_NAME,
NOTIFY_DBUS_CORE_OBJECT,
NOTIFY_DBUS_CORE_INTERFACE);
dbus_g_connection_unref (bus);
g_signal_connect (_proxy,
"destroy",
G_CALLBACK (on_proxy_destroy),
NULL);
dbus_g_object_register_marshaller (notify_marshal_VOID__UINT_UINT,
G_TYPE_NONE,
G_TYPE_UINT,
G_TYPE_UINT,
G_TYPE_INVALID);
dbus_g_object_register_marshaller (notify_marshal_VOID__UINT_STRING,
G_TYPE_NONE,
G_TYPE_UINT,
G_TYPE_STRING,
G_TYPE_INVALID);
dbus_g_proxy_add_signal (_proxy,
"NotificationClosed",
G_TYPE_UINT,
G_TYPE_UINT,
G_TYPE_INVALID);
dbus_g_proxy_add_signal (_proxy,
"ActionInvoked",
G_TYPE_UINT,
G_TYPE_STRING,
G_TYPE_INVALID);
if (!_notify_update_spec_version ()) {
return NULL;
}
g_object_add_weak_pointer (G_OBJECT (_proxy), (gpointer *) &_proxy);
return _proxy;
}
/**
* notify_get_server_caps:
*
* Synchronously queries the server for its capabilities and returns them in a #GList.
* Queries the server for its capabilities and returns them in a #GList.
*
* Returns: (transfer full) (element-type utf8): a #GList of server capability strings. Free
* the list elements with g_free() and the list itself with g_list_free().
* Returns: A #GList of server capability strings.
*/
GList *
notify_get_server_caps (void)
{
GDBusProxy *proxy;
GVariant *result;
char **cap, **caps;
GList *list = NULL;
GError *error;
char **caps;
char **cap;
GList *result;
DBusGProxy *proxy;
proxy = _notify_get_proxy (NULL);
caps = NULL;
result = NULL;
proxy = _notify_get_g_proxy ();
if (proxy == NULL) {
g_warning ("Failed to connect to proxy");
return NULL;
}
if (_notify_uses_portal_notifications ()) {
list = g_list_prepend (list, g_strdup ("actions"));
list = g_list_prepend (list, g_strdup ("body"));
list = g_list_prepend (list, g_strdup ("body-images"));
list = g_list_prepend (list, g_strdup ("icon-static"));
return list;
}
result = g_dbus_proxy_call_sync (proxy,
"GetCapabilities",
g_variant_new ("()"),
G_DBUS_CALL_FLAGS_NONE,
-1 /* FIXME shorter timeout? */,
NULL,
NULL);
if (result == NULL) {
error = NULL;
if (!dbus_g_proxy_call (proxy,
"GetCapabilities",
&error,
G_TYPE_INVALID,
G_TYPE_STRV,
&caps,
G_TYPE_INVALID)) {
g_error_free (error);
return NULL;
}
if (!g_variant_is_of_type (result, G_VARIANT_TYPE ("(as)"))) {
g_variant_unref (result);
return NULL;
}
g_variant_get (result, "(^as)", &caps);
for (cap = caps; *cap != NULL; cap++) {
list = g_list_prepend (list, *cap);
result = g_list_append (result, g_strdup (*cap));
}
g_free (caps);
g_variant_unref (result);
g_strfreev (caps);
return g_list_reverse (list);
return result;
}
/**
* notify_get_server_info:
* @ret_name: (out) (allow-none) (transfer full): a location to store the server name, or %NULL
* @ret_vendor: (out) (allow-none) (transfer full): a location to store the server vendor, or %NULL
* @ret_version: (out) (allow-none) (transfer full): a location to store the server version, or %NULL
* @ret_spec_version: (out) (allow-none) (transfer full): a location to store the version the service is compliant with, or %NULL
* @ret_name: The resulting server name.
* @ret_vendor: The resulting server vendor.
* @ret_version: The resulting server version.
* @ret_spec_version: The resulting version of the specification the server is
* compliant with.
*
* Synchronously queries the server for its information, specifically, the name, vendor,
* Queries the server for its information, specifically, the name, vendor,
* server version, and the version of the notifications specification that it
* is compliant with.
*
* Returns: %TRUE if successful, and the variables passed will be set, %FALSE
* on error. The returned strings must be freed with g_free
* Returns: %TRUE if successful, and the variables passed will be set. %FALSE
* on failure.
*/
gboolean
notify_get_server_info (char **ret_name,
@ -667,7 +296,57 @@ notify_get_server_info (char **ret_name,
char **ret_version,
char **ret_spec_version)
{
return _notify_get_server_info (ret_name, ret_vendor, ret_version, ret_spec_version, NULL);
GError *error;
DBusGProxy *proxy;
char *name;
char *vendor;
char *version;
char *spec_version;
proxy = _notify_get_g_proxy ();
if (proxy == NULL) {
return FALSE;
}
error = NULL;
if (!dbus_g_proxy_call (proxy,
"GetServerInformation",
&error,
G_TYPE_INVALID,
G_TYPE_STRING, &name,
G_TYPE_STRING, &vendor,
G_TYPE_STRING, &version,
G_TYPE_STRING, &spec_version,
G_TYPE_INVALID)) {
g_error_free (error);
return FALSE;
}
if (ret_name != NULL) {
*ret_name = name;
} else {
g_free (name);
}
if (ret_vendor != NULL) {
*ret_vendor = vendor;
} else {
g_free (vendor);
}
if (ret_version != NULL) {
*ret_version = version;
} else {
g_free (version);
}
if (ret_spec_version != NULL) {
*ret_spec_version = spec_version;
} else {
g_free (spec_version);
}
return TRUE;
}
void

45
libnotify/notify.h
View File

@ -23,6 +23,7 @@
#define _LIBNOTIFY_NOTIFY_H_
#include <glib.h>
#include <time.h>
#include <libnotify/notification.h>
#include <libnotify/notify-enum-types.h>
@ -30,15 +31,55 @@
G_BEGIN_DECLS
/**
* Initializes the notifications library.
*
* @param app_name The application name.
*
* @return TRUE if the library initialized properly.
*/
gboolean notify_init (const char *app_name);
/**
* Uninitializes the notifications library.
*
* This will be automatically called on exit unless previously called.
*/
void notify_uninit (void);
/**
* Returns whether or not the notification library is initialized.
*
* @return TRUE if the library is initialized, or FALSE.
*/
gboolean notify_is_initted (void);
const char *notify_get_app_name (void);
void notify_set_app_name (const char *app_name);
/**
* Returns the name of the application set when notify_init() was called.
*
* @return The name of the application.
*/
const gchar *notify_get_app_name (void);
/**
* Returns the capabilities of the notification server.
*
* @return A list of capability strings. These strings must be freed.
*/
GList *notify_get_server_caps (void);
/**
* Returns the server notification information.
*
* The strings returned must be freed.
*
* @param ret_name The returned product name of the server.
* @param ret_vendor The returned vendor.
* @param ret_version The returned server version.
* @param ret_spec_version The returned specification version supported.
*
* @return TRUE if the call succeeded, or FALSE if there were errors.
*/
gboolean notify_get_server_info (char **ret_name,
char **ret_vendor,
char **ret_version,

8
libnotify/notifynotification.xml Normal file
View File

@ -0,0 +1,8 @@
<?xml version="1.0" encoding="UTF-8" ?>
<node name="/org/freedesktop/Notification">
<interface name="org.freedesktop.NotificationListener">
</interface>
</node>

85
meson.build
View File

@ -1,85 +0,0 @@
project('libnotify',
'c',
version: '0.8.1',
meson_version: '>= 0.47.0')
gnome = import('gnome')
pkgconfig = import('pkgconfig')
cc = meson.get_compiler('c')
################################################################
# libtool versioning
################################################################
#
# +1 : 0 : +1 == new interface that does not break old one.
# +1 : 0 : 0 == removed an interface. Breaks old apps.
# ? : +1 : ? == internal changes that doesn't break anything.
#
# CURRENT : REVISION : AGE
#
LT_CURRENT=4
LT_REVISION=0
LT_AGE=0
API_VERSION = 7
VERSION_ARRAY = meson.project_version().split('.')
# Minor version is hardcoded until we have a real API break
MODULE_VERSION = '@0@.@1@'.format(VERSION_ARRAY[0], API_VERSION)
LIBNAME = meson.project_name().split('lib')[1]
default_includes = include_directories('.')
prefix = get_option('prefix')
includedir = join_paths(prefix, get_option('includedir'))
docdir = join_paths(prefix, get_option('datadir'), 'doc', meson.project_name())
man1dir = join_paths(prefix, get_option('mandir'), 'man1')
libnotify_deps = []
extra_deps = []
glib_req_version = '>= 2.38.0'
gdk_pixbuf_dep = dependency('gdk-pixbuf-2.0')
glib_dep = dependency('glib-2.0', version: glib_req_version)
gio_dep = dependency('gio-2.0', version: glib_req_version)
gtk_dep = dependency('gtk+-3.0', version: '>= 2.90', required: get_option('tests'))
libnotify_deps = [gdk_pixbuf_dep, gio_dep, glib_dep]
tests_deps = [gtk_dep]
conf = configuration_data()
conf.set_quoted('VERSION', meson.project_version())
configure_file(input: 'config.h.meson',
output : 'config.h',
configuration : conf)
if get_option('man')
xsltproc = find_program('xsltproc', required: true)
stylesheet = 'http://docbook.sourceforge.net/release/xsl-ns/current/manpages/docbook.xsl'
xsltproc_command = [
xsltproc,
'--nonet',
'--stringparam', 'man.output.quietly', '1',
'--stringparam', 'funcsynopsis.style', 'ansi',
'--stringparam', 'man.th.extra1.suppress', '1',
'-o', '@OUTPUT@',
stylesheet,
'@INPUT@',
]
testrun = run_command(xsltproc, '--nonet', stylesheet, check: false)
if testrun.returncode() != 0
error('DocBook stylesheet for generating man pages not found, you need to install docbook-xsl-ns or similar package.')
endif
endif
subdir('libnotify')
subdir('tools')
subdir('docs')
if get_option('tests')
subdir('tests')
endif

20
meson_options.txt
View File

@ -1,20 +0,0 @@
option('tests',
type: 'boolean',
value: true,
description: 'Build tests')
option('introspection',
type: 'feature',
value: 'enabled',
description: 'Enable GObject introspection')
option('man',
type: 'boolean',
value: true,
description: 'Enable generating the manual page (depends on xsltproc)')
option('gtk_doc',
type: 'boolean',
value: true,
description: 'Enable generating the API reference (depends on GTK-Doc)')
option('docbook_docs',
type: 'feature',
value: 'auto',
description: 'Build DocBook documentation (requires xmlto)')

76
tests/Makefile.am Normal file
View File

@ -0,0 +1,76 @@
noinst_PROGRAMS = \
test-replace \
test-replace-widget \
test-server-info \
test-default-action \
test-multi-actions \
test-image \
test-basic \
test-error \
test-markup \
test-rtl \
test-size-changes \
test-urgency \
test-xy \
test-xy-actions \
test-xy-stress
common_ldflags = \
$(top_builddir)/libnotify/libnotify.la \
$(PACKAGE_LIBS) \
$(GDK_LIBS)
test_replace_SOURCES = test-replace.c
test_replace_LDADD = $(common_ldflags)
test_replace_widget_SOURCES = test-replace-widget.c
test_replace_widget_LDADD = $(common_ldflags)
test_server_info_SOURCES = test-server-info.c
test_server_info_LDADD = $(common_ldflags)
test_size_changes_SOURCES = test-size-changes.c
test_size_changes_LDADD = $(common_ldflags)
test_default_action_SOURCES = test-default-action.c
test_default_action_LDADD = $(common_ldflags)
test_multi_actions_SOURCES = test-multi-actions.c
test_multi_actions_LDADD = $(common_ldflags)
test_image_SOURCES = test-image.c
test_image_LDADD = $(common_ldflags)
test_basic_SOURCES = test-basic.c
test_basic_LDADD = $(common_ldflags)
test_error_SOURCES = test-error.c
test_error_LDADD = $(common_ldflags)
test_markup_SOURCES = test-markup.c
test_markup_LDADD = $(common_ldflags)
test_urgency_SOURCES = test-urgency.c
test_urgency_LDADD = $(common_ldflags)
test_xy_SOURCES = test-xy.c
test_xy_LDADD = $(common_ldflags)
test_xy_actions_SOURCES = test-xy-actions.c
test_xy_actions_LDADD = $(common_ldflags)
test_xy_stress_SOURCES = test-xy-stress.c
test_xy_stress_LDADD = $(common_ldflags)
test_rtl_SOURCES = test-rtl.c
test_rtl_LDADD = $(common_ldflags)
EXTRA_DIST = applet-critical.png
INCLUDES = \
-I$(top_srcdir) \
-I$(top_srcdir)/libnotify \
$(PACKAGE_CFLAGS) \
$(GDK_CFLAGS)
-include $(top_srcdir)/git.mk

28
tests/meson.build
View File

@ -1,28 +0,0 @@
test_progs = [
'replace',
'replace-widget',
'server-info',
'default-action',
'multi-actions',
'action-icons',
'image',
'basic',
'error',
'markup',
'persistence',
'removal',
'resident',
'rtl',
'size-changes',
'transient',
'urgency',
'xy',
'xy-actions',
'xy-stress',
]
foreach tprog: test_progs
executable('test-' + tprog, ['test-' + tprog + '.c'],
dependencies: [libnotify_dep, tests_deps],
)
endforeach

133
tests/test-action-icons.c
View File

@ -1,133 +0,0 @@
/* -*- Mode: C; tab-width: 8; indent-tabs-mode: nil; c-basic-offset: 8 -*-
*
*
* This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Lesser General Public
* License as published by the Free Software Foundation; either
* version 2.1 of the License, or(at your option) any later version.
*
* This library is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public
* License along with this library; if not, write to the
* Free Software Foundation, Inc., 59 Temple Place - Suite 330,
* Boston, MA 02111-1307, USA.
*/
#include <libnotify/notify.h>
#include <stdio.h>
#include <unistd.h>
#include <stdlib.h>
#include <string.h>
static GMainLoop *loop;
static void
previous_callback (NotifyNotification *n,
const char *action)
{
g_assert (action != NULL);
g_assert (strcmp (action, "media-skip-backward") == 0);
printf ("You clicked Previous\n");
notify_notification_close (n, NULL);
g_main_loop_quit (loop);
}
static void
pause_callback (NotifyNotification *n,
const char *action)
{
g_assert (action != NULL);
g_assert (strcmp (action, "media-playback-pause") == 0);
printf ("You clicked Pause\n");
notify_notification_close (n, NULL);
g_main_loop_quit (loop);
}
static void
next_callback (NotifyNotification *n,
const char *action)
{
g_assert (action != NULL);
g_assert (strcmp (action, "media-skip-forward") == 0);
printf ("You clicked Next\n");
notify_notification_close (n, NULL);
g_main_loop_quit (loop);
}
int
main (int argc, char **argv)
{
NotifyNotification *n;
if (!notify_init ("Action Icon Test"))
exit (1);
loop = g_main_loop_new (NULL, FALSE);
n = notify_notification_new ("Music Player",
"Some solid funk",
NULL);
notify_notification_set_hint (n, "action-icons", g_variant_new_boolean (TRUE));
notify_notification_add_action (n,
"media-skip-backward",
"Previous",
(NotifyActionCallback) previous_callback,
NULL,
NULL);
notify_notification_add_action (n,
"media-playback-pause",
"Pause",
(NotifyActionCallback) pause_callback,
NULL,
NULL);
notify_notification_add_action (n,
"media-skip-forward",
"Next",
(NotifyActionCallback) next_callback,
NULL,
NULL);
if (!notify_notification_show (n, NULL)) {
fprintf (stderr, "failed to send notification\n");
return 1;
}
n = notify_notification_new ("Music Player",
"Shouldn't have icons",
NULL);
notify_notification_set_hint (n, "action-icons", g_variant_new_boolean (FALSE));
notify_notification_add_action (n,
"media-skip-backward",
"Previous",
(NotifyActionCallback) previous_callback,
NULL,
NULL);
if (!notify_notification_show (n, NULL)) {
fprintf (stderr, "failed to send notification\n");
return 1;
}
g_main_loop_run (loop);
return 0;
}

3
tests/test-basic.c
View File

@ -34,6 +34,7 @@ main ()
/* Long summary */
n = notify_notification_new ("Summary that is very long 8374983278r32j4 rhjjfh dw8f 43jhf 8ds7 ur2389f jdbjkt h8924yf jkdbjkt 892hjfiHER98HEJIF BDSJHF hjdhF JKLH 890YRHEJHFU 89HRJKSHdd dddd ddddd dddd ddddd dddd ddddd dddd dddd ddd ddd dddd Fdd d ddddd dddddddd ddddddddhjkewdkjsjfjk sdhkjf hdkj dadasdadsa adsd asd sd saasd fadskfkhsjf hsdkhfkshfjkhsd kjfhsjdkhfj ksdhfkjshkjfsd sadhfjkhaskd jfhsdajkfhkjs dhfkjsdhfkjs adhjkfhasdkj fhdsakjhfjk asdhkjkfhd akfjshjfsk afhjkasdhf jkhsdaj hf kjsdfahkfh sakjhfksdah kfdashkjf ksdahfj shdjdh",
"Content",
NULL,
NULL);
notify_notification_set_timeout (n, 3000); //3 seconds
@ -47,6 +48,7 @@ main ()
/* Long message */
n = notify_notification_new ("Summary",
"Content that is very long 8374983278r32j4 rhjjfh dw8f 43jhf 8ds7 ur2389f jdbjkt h8924yf jkdbjkt 892hjfiHER98HEJIF BDSJHF hjdhF JKLH 890YRHEJHFU 89HRJKSHdd dddd ddddd dddd ddddd dddd ddddd dddd dddd ddd ddd dddd Fdd d ddddd dddddddd ddddddddhjkewdkjsjfjk sdhkjf hdkj dadasdadsa adsd asd sd saasd fadskfkhsjf hsdkhfkshfjkhsd kjfhsjdkhfj ksdhfkjshkjfsd sadhfjkhaskd jfhsdajkfhkjs dhfkjsdhfkjs adhjkfhasdkj fhdsakjhfjk asdhkjkfhd akfjshjfsk afhjkasdhf jkhsdaj hf kjsdfahkfh sakjhfksdah kfdashkjf ksdahfj shdjdh",
NULL,
NULL);
notify_notification_set_timeout (n, 3000); //3 seconds
@ -59,6 +61,7 @@ main ()
/* Summary only */
n = notify_notification_new ("Summary only there is no message content",
NULL,
NULL,
NULL);
notify_notification_set_timeout (n, NOTIFY_EXPIRES_NEVER);

13
tests/test-default-action.c
View File

@ -27,6 +27,13 @@
#include <assert.h>
#include <string.h>
#define DBUS_API_SUBJECT_TO_CHANGE
#include <glib.h>
#include <dbus/dbus.h>
#include <dbus/dbus-glib.h>
#include <dbus/dbus-glib-lowlevel.h>
static GMainLoop *loop;
static void
@ -47,13 +54,17 @@ int
main ()
{
NotifyNotification *n;
DBusConnection *conn;
if (!notify_init ("Default Action Test"))
exit (1);
conn = dbus_bus_get (DBUS_BUS_SESSION, NULL);
loop = g_main_loop_new (NULL, FALSE);
n = notify_notification_new ("Matt is online", "", NULL);
dbus_connection_setup_with_g_main (conn, NULL);
n = notify_notification_new ("Matt is online", "", NULL, NULL);
notify_notification_set_timeout (n, NOTIFY_EXPIRES_DEFAULT);
notify_notification_add_action (n,
"default",

4
tests/test-error.c
View File

@ -29,9 +29,11 @@ main ()
{
NotifyNotification *n;
g_type_init ();
notify_init ("Error Handling");
n = notify_notification_new ("Summary", "Content", NULL);
n = notify_notification_new ("Summary", "Content", NULL, NULL);
notify_notification_set_timeout (n, 3000); //3 seconds
/* TODO: Create an error condition */

55
tests/test-gir.py
View File

@ -1,55 +0,0 @@
#!/usr/bin/python
# @file tests/test-gir.py Unit test: Test GI repository
#
# @Copyright (C) 2010 Canonical Ltd.
# Author: Martin Pitt <martin.pitt@ubuntu.com>
#
# This library is free software; you can redistribute it and/or
# modify it under the terms of the GNU Lesser General Public
# License as published by the Free Software Foundation; either
# version 2.1 of the License, or (at your option) any later version.
#
# This library is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
# Lesser General Public License for more details.
#
# You should have received a copy of the GNU Lesser General Public
# License along with this library; if not, write to the
# Free Software Foundation, Inc., 59 Temple Place - Suite 330,
# Boston, MA 02111-1307, USA.
import os
# use our local typelib
os.environ['GI_TYPELIB_PATH'] = 'libnotify:' + os.environ.get('GI_TYPELIB_PATH', '')
from gi.repository import Notify
assert Notify.is_initted() == False
Notify.init('test')
assert Notify.is_initted() == True
print 'server info:', Notify.get_server_info()
print 'server capabilities:', Notify.get_server_caps()
n = Notify.Notification.new('title', None, None)
n.show()
n = Notify.Notification.new('title', 'text', None)
n.show()
n = Notify.Notification.new('title', 'text', 'gtk-ok')
n.show()
n.update('New Title', None, None)
n.show()
n.update('Newer Title', 'New Body', None)
n.show()
def callback():
print 'Do it! Callback'
n = Notify.Notification.new('Action', 'Here we go!', 'gtk-alert')
n.add_action('doit', 'Do it!', callback, None, None)
n.show()

44
tests/test-image.c
View File

@ -31,7 +31,14 @@
#include <sys/stat.h>
#include <unistd.h>
#include <fcntl.h>
#define DBUS_API_SUBJECT_TO_CHANGE
#include <glib.h>
#include <gtk/gtk.h>
#include <dbus/dbus.h>
#include <dbus/dbus-glib.h>
#include <dbus/dbus-glib-lowlevel.h>
GMainLoop *loop;
NotifyNotification *n;
@ -41,7 +48,8 @@ main (int argc, char *argv[])
{
char *file;
char *uri;
GdkPixbuf *pixbuf;
GdkPixbuf *icon;
GtkWidget *helper;
gtk_init (&argc, &argv);
@ -51,7 +59,8 @@ main (int argc, char *argv[])
/* Stock icon */
n = notify_notification_new ("Icon Test",
"Testing stock icon",
"appointment-new");
"appointment-new",
NULL);
if (!notify_notification_show (n, NULL)) {
fprintf (stderr, "failed to send notification\n");
@ -71,7 +80,8 @@ main (int argc, char *argv[])
/* URIs */
n = notify_notification_new ("Alert!",
"Testing URI icons",
uri);
uri,
NULL);
if (!notify_notification_show (n, NULL)) {
fprintf (stderr, "failed to send notification\n");
@ -83,24 +93,30 @@ main (int argc, char *argv[])
/* Raw image */
n = notify_notification_new ("Raw image test",
"Testing sending raw pixbufs",
NULL,
NULL);
pixbuf = gtk_icon_theme_load_icon (gtk_icon_theme_get_for_screen (gdk_screen_get_default ()),
"folder-open",
48,
GTK_ICON_LOOKUP_USE_BUILTIN,
NULL);
if (pixbuf == NULL) {
fprintf (stderr, "failed to render pixbuf\n");
return 1;
}
notify_notification_set_image_from_pixbuf (n, pixbuf);
g_object_unref (pixbuf);
/*
* This is just a hack to get a stock icon's pixbuf in a realworld app
* if you were sending bitmapped data you would know the file location
* and open it up with a method that could generate a bmp for you
*/
helper = gtk_button_new ();
icon = gtk_widget_render_icon (helper,
GTK_STOCK_DIALOG_QUESTION,
GTK_ICON_SIZE_DIALOG,
NULL);
gtk_widget_destroy (helper);
notify_notification_set_icon_from_pixbuf (n, icon);
g_object_unref (G_OBJECT (icon));
if (!notify_notification_show (n, NULL)) {
fprintf (stderr, "failed to send notification\n");
return 1;
}
g_object_unref (G_OBJECT (n));
return 0;
}

1
tests/test-markup.c
View File

@ -34,6 +34,7 @@ main ()
n = notify_notification_new ("Summary",
"Some <b>bold</b>, <u>underlined</u>, <i>italic</i>, "
"<a href='http://www.google.com'>linked</a> text",
NULL,
NULL);
notify_notification_set_timeout (n, 3000); //3 seconds

15
tests/test-multi-actions.c
View File

@ -26,6 +26,13 @@
#include <stdlib.h>
#include <string.h>
#define DBUS_API_SUBJECT_TO_CHANGE
#include <glib.h>
#include <dbus/dbus.h>
#include <dbus/dbus-glib.h>
#include <dbus/dbus-glib-lowlevel.h>
static GMainLoop *loop;
static void
@ -75,17 +82,21 @@ int
main (int argc, char **argv)
{
NotifyNotification *n;
DBusConnection *conn;
if (!notify_init ("Multi Action Test"))
exit (1);
conn = dbus_bus_get (DBUS_BUS_SESSION, NULL);
loop = g_main_loop_new (NULL, FALSE);
dbus_connection_setup_with_g_main (conn, NULL);
n = notify_notification_new ("Low disk space",
"You can free up some disk space by "
"emptying the trash can.",
"drive-harddisk-symbolic");
notify_notification_set_hint (n, "transient", g_variant_new_boolean (TRUE));
NULL,
NULL);
notify_notification_set_urgency (n, NOTIFY_URGENCY_CRITICAL);
notify_notification_set_timeout (n, NOTIFY_EXPIRES_DEFAULT);
notify_notification_add_action (n,

94
tests/test-persistence.c
View File

@ -1,94 +0,0 @@
/* -*- Mode: C; tab-width: 8; indent-tabs-mode: nil; c-basic-offset: 8 -*-
*
* This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Lesser General Public
* License as published by the Free Software Foundation; either
* version 2.1 of the License, or(at your option) any later version.
*
* This library is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public
* License along with this library; if not, write to the
* Free Software Foundation, Inc., 59 Temple Place - Suite 330,
* Boston, MA 02111-1307, USA.
*/
#include <libnotify/notify.h>
#include <stdio.h>
#include <unistd.h>
#include <string.h>
#include <glib.h>
#include <gtk/gtk.h>
static gboolean
server_has_persistence (void)
{
gboolean has;
GList *caps;
GList *l;
caps = notify_get_server_caps ();
if (caps == NULL) {
fprintf (stderr, "Failed to receive server caps.\n");
return FALSE;
}
l = g_list_find_custom (caps, "persistence", (GCompareFunc)strcmp);
has = l != NULL;
g_list_foreach (caps, (GFunc) g_free, NULL);
g_list_free (caps);
return has;
}
static void
install_callback (NotifyNotification *n,
const char *action)
{
g_assert (action != NULL);
g_assert (strcmp (action, "install") == 0);
printf ("You clicked Install\n");
gtk_main_quit ();
}
int
main (int argc, char *argv[])
{
NotifyNotification *n;
gtk_init (&argc, &argv);
notify_init ("Persistence Test");
n = notify_notification_new ("Software Updates Available",
"Important updates for your apps are now available.",
"software-update-available-symbolic");
notify_notification_add_action (n,
"install",
"Install now",
(NotifyActionCallback) install_callback,
NULL,
NULL);
notify_notification_set_timeout (n, 0); //don't timeout
notify_notification_show (n, NULL);
if (!server_has_persistence ()) {
GtkStatusIcon *icon;
g_message ("Server does not support persistence; using a status icon");
icon = gtk_status_icon_new_from_icon_name ("software-update-available-symbolic");
gtk_status_icon_set_tooltip_markup (icon, "<b>Software Updates Available</b>\nImportant updates for your apps are now available.");
gtk_status_icon_set_visible (icon, TRUE);
} else {
g_message ("Server supports persistence; status icon not needed");
}
gtk_main ();
return 0;
}

112
tests/test-removal.c
View File

@ -1,112 +0,0 @@
/* -*- Mode: C; tab-width: 8; indent-tabs-mode: nil; c-basic-offset: 8 -*-
*
* This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Lesser General Public
* License as published by the Free Software Foundation; either
* version 2.1 of the License, or(at your option) any later version.
*
* This library is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public
* License along with this library; if not, write to the
* Free Software Foundation, Inc., 59 Temple Place - Suite 330,
* Boston, MA 02111-1307, USA.
*/
#include <stdlib.h>
#include <libnotify/notify.h>
#include <gtk/gtk.h>
static void
next_callback (NotifyNotification *n,
const char *action)
{
g_assert (action != NULL);
printf ("You clicked Next\n");
notify_notification_close (n, NULL);
gtk_main_quit ();
}
int
main (int argc, char *argv[])
{
NotifyNotification *n;
gtk_init (&argc, &argv);
notify_init ("Urgency");
n = notify_notification_new ("Low Urgency",
"Joe signed online.",
NULL);
notify_notification_set_urgency (n, NOTIFY_URGENCY_LOW);
if (!notify_notification_show (n, NULL)) {
fprintf (stderr, "failed to send notification\n");
exit (1);
}
sleep (3);
if (!notify_notification_close (n, NULL)) {
fprintf (stderr, "failed to remove notification\n");
exit (1);
}
g_object_unref (G_OBJECT (n));
n = notify_notification_new ("Normal Urgency",
"You have a meeting in 10 minutes.",
NULL);
notify_notification_set_urgency (n, NOTIFY_URGENCY_NORMAL);
if (!notify_notification_show (n, NULL)) {
fprintf (stderr, "failed to send notification\n");
exit (1);
}
sleep (3);
if (!notify_notification_close (n, NULL)) {
fprintf (stderr, "failed to remove notification\n");
exit (1);
}
g_object_unref (G_OBJECT (n));
n = notify_notification_new ("Critical Urgency",
"This message will self-destruct in 10 seconds.",
NULL);
notify_notification_set_urgency (n, NOTIFY_URGENCY_CRITICAL);
notify_notification_set_timeout (n, NOTIFY_EXPIRES_NEVER);
notify_notification_add_action (n,
"media-skip-forward",
"Next",
(NotifyActionCallback) next_callback,
NULL,
NULL);
if (!notify_notification_show (n, NULL)) {
fprintf (stderr, "failed to send notification\n");
exit (1);
}
sleep (3);
if (!notify_notification_close (n, NULL)) {
fprintf (stderr, "failed to remove notification\n");
exit (1);
}
gtk_main ();
g_object_unref (G_OBJECT (n));
return 0;
}

3
tests/test-replace-widget.c
View File

@ -74,7 +74,8 @@ main (int argc, char *argv[])
n = notify_notification_new ("Widget Attachment Test",
"Button has not been clicked yet",
NULL); //no icon
NULL, //no icon
button); //attach to button
notify_notification_set_timeout (n, 0); //don't timeout

6
tests/test-replace.c
View File

@ -28,11 +28,15 @@ main ()
GError *error;
error = NULL;
g_type_init ();
notify_init ("Replace Test");
n = notify_notification_new ("Summary",
"First message",
NULL); //no icon
NULL, //no icon
NULL); //don't attach to widget
notify_notification_set_timeout (n, 0); //don't timeout

149
tests/test-resident.c
View File

@ -1,149 +0,0 @@
/* -*- Mode: C; tab-width: 8; indent-tabs-mode: nil; c-basic-offset: 8 -*-
*
* This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Lesser General Public
* License as published by the Free Software Foundation; either
* version 2.1 of the License, or(at your option) any later version.
*
* This library is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public
* License along with this library; if not, write to the
* Free Software Foundation, Inc., 59 Temple Place - Suite 330,
* Boston, MA 02111-1307, USA.
*/
#include <libnotify/notify.h>
#include <stdio.h>
#include <unistd.h>
#include <stdlib.h>
#include <string.h>
static GMainLoop *loop;
static int counter;
static gboolean is_playing;
static void
prev_callback (NotifyNotification *n,
const char *action)
{
char *body;
g_assert (action != NULL);
g_assert (strcmp (action, "previous") == 0);
printf ("You clicked Previous\n");
body = g_strdup_printf ("Playing some fine song %d", --counter);
notify_notification_update (n,
"Music Player",
body,
"audio-x-generic");
g_free (body);
if (!notify_notification_show (n, NULL)) {
fprintf (stderr, "failed to send update\n");
}
}
static void
pause_callback (NotifyNotification *n,
const char *action)
{
char *body;
g_assert (action != NULL);
g_assert (strcmp (action, "pause") == 0);
printf ("You clicked Play/Pause\n");
is_playing = !is_playing;
if (is_playing) {
body = g_strdup_printf ("Playing some fine song %d", counter);
} else {
body = g_strdup_printf ("Not playing some fine song %d", counter);
}
notify_notification_update (n,
"Music Player",
body,
"audio-x-generic");
g_free (body);
if (!notify_notification_show (n, NULL)) {
fprintf (stderr, "failed to send update\n");
}
}
static void
next_callback (NotifyNotification *n,
const char *action)
{
char *body;
g_assert (action != NULL);
g_assert (strcmp (action, "next") == 0);
printf ("You clicked Next\n");
body = g_strdup_printf ("Playing some fine song %d", ++counter);
notify_notification_update (n,
"Music Player",
body,
"audio-x-generic");
g_free (body);
if (!notify_notification_show (n, NULL)) {
fprintf (stderr, "failed to send update\n");
}
}
int
main (int argc, char **argv)
{
NotifyNotification *n;
GVariant *hint;
if (!notify_init ("Resident Test"))
exit (1);
loop = g_main_loop_new (NULL, FALSE);
counter = 0;
is_playing = TRUE;
n = notify_notification_new ("Music Player",
"Playing some fine song",
"audio-x-generic");
hint = g_variant_new_boolean (TRUE);
notify_notification_set_hint (n, "resident", hint);
notify_notification_add_action (n,
"previous",
"Previous",
(NotifyActionCallback) prev_callback,
NULL,
NULL);
notify_notification_add_action (n,
"pause",
"Pause",
(NotifyActionCallback)
pause_callback,
NULL,
NULL);
notify_notification_add_action (n,
"next",
"Next",
(NotifyActionCallback) next_callback,
NULL,
NULL);
if (!notify_notification_show (n, NULL)) {
fprintf (stderr, "failed to send notification\n");
return 1;
}
g_main_loop_run (loop);
return 0;
}

1
tests/test-rtl.c
View File

@ -34,6 +34,7 @@ main ()
n = notify_notification_new ("اختبار",
"يوفر ويكي عربآيز مناخا للنقاش وتبادل الخبرات والمعرفة حول اللغة العربية ولسانياتها ومايتعلّق بدعمها والإرتقاء بها في الحوسبة عموماً والبرمجيات الحرة على وجه الخصوص. هذا الويكي عبارة عن بيئة تعاونية تشاركية مفتوحة للجميع بدون قيود، لغتنا الجميلة بانتظار مساهمتك فلا تبخل عليها ",
NULL,
NULL);
notify_notification_set_timeout (n, 3000);

3
tests/test-size-changes.c
View File

@ -33,6 +33,7 @@ main ()
n1 = notify_notification_new ("Notification 1",
"Notification number 1!",
NULL,
NULL);
notify_notification_set_timeout (n1, 7000);
@ -45,6 +46,7 @@ main ()
n2 = notify_notification_new ("Notification 2",
"Notification number 2!",
NULL,
NULL);
notify_notification_set_timeout (n2, 7000);
@ -56,6 +58,7 @@ main ()
n3 = notify_notification_new ("Notification 3",
"Notification number 3!",
NULL,
NULL);
notify_notification_set_timeout (n3, 7000);

52
tests/test-transient.c
View File

@ -1,52 +0,0 @@
/* -*- Mode: C; tab-width: 8; indent-tabs-mode: nil; c-basic-offset: 8 -*-
*
* This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Lesser General Public
* License as published by the Free Software Foundation; either
* version 2.1 of the License, or(at your option) any later version.
*
* This library is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public
* License along with this library; if not, write to the
* Free Software Foundation, Inc., 59 Temple Place - Suite 330,
* Boston, MA 02111-1307, USA.
*/
#include <libnotify/notify.h>
#include <stdio.h>
#include <unistd.h>
#include <stdlib.h>
#include <string.h>
static GMainLoop *loop;
int
main (int argc, char **argv)
{
NotifyNotification *n;
GVariant *hint;
if (!notify_init ("Transient Test"))
exit (1);
loop = g_main_loop_new (NULL, FALSE);
n = notify_notification_new ("Some transient change",
"Something happened",
"audio-volume-medium");
hint = g_variant_new_boolean (TRUE);
notify_notification_set_hint (n, "transient", hint);
if (!notify_notification_show (n, NULL)) {
fprintf (stderr, "failed to send notification\n");
return 1;
}
g_main_loop_run (loop);
return 0;
}

6
tests/test-urgency.c
View File

@ -32,6 +32,7 @@ main (int argc, char *argv[])
n = notify_notification_new ("Low Urgency",
"Joe signed online.",
NULL,
NULL);
notify_notification_set_urgency (n, NOTIFY_URGENCY_LOW);
if (!notify_notification_show (n, NULL)) {
@ -44,6 +45,7 @@ main (int argc, char *argv[])
n = notify_notification_new ("Normal Urgency",
"You have a meeting in 10 minutes.",
NULL,
NULL);
notify_notification_set_urgency (n, NOTIFY_URGENCY_NORMAL);
if (!notify_notification_show (n, NULL)) {
@ -55,7 +57,9 @@ main (int argc, char *argv[])
n = notify_notification_new ("Critical Urgency",
"This message will self-destruct in 10 seconds.",
"This message will self-destruct in 10 "
"seconds.",
NULL,
NULL);
notify_notification_set_urgency (n, NOTIFY_URGENCY_CRITICAL);
notify_notification_set_timeout (n, 10000); // 10 seconds

10
tests/test-xy-actions.c
View File

@ -24,6 +24,11 @@
#include <stdio.h>
#include <unistd.h>
#define DBUS_API_SUBJECT_TO_CHANGE
#include <dbus/dbus.h>
#include <dbus/dbus-glib.h>
#include <dbus/dbus-glib-lowlevel.h>
static GMainLoop *loop;
static void
@ -39,14 +44,19 @@ int
main (int argc, char **argv)
{
NotifyNotification *n;
DBusConnection *conn;
notify_init ("XY");
conn = dbus_bus_get (DBUS_BUS_SESSION, NULL);
loop = g_main_loop_new (NULL, FALSE);
dbus_connection_setup_with_g_main (conn, NULL);
n = notify_notification_new ("System update available",
"New system updates are available. It is "
"recommended that you install the updates.",
NULL,
NULL);
notify_notification_set_hint_int32 (n, "x", 600);

2
tests/test-xy-stress.c
View File

@ -42,7 +42,7 @@ emit_notification (int x, int y)
x,
y);
n = notify_notification_new ("X, Y Test", buffer, NULL);
n = notify_notification_new ("X, Y Test", buffer, NULL, NULL);
g_free (buffer);
notify_notification_set_hint_int32 (n, "x", x);

1
tests/test-xy.c
View File

@ -33,6 +33,7 @@ main ()
n = notify_notification_new ("X, Y Test",
"This notification should point to 150, 10",
NULL,
NULL);
notify_notification_set_hint_int32 (n, "x", 150);

16
tools/Makefile.am Normal file
View File

@ -0,0 +1,16 @@
bin_PROGRAMS = notify-send
common_ldflags = \
$(top_builddir)/libnotify/libnotify.la \
$(PACKAGE_LIBS)
notify_send_SOURCES = notify-send.c
notify_send_LDADD = $(common_ldflags)
INCLUDES = \
-I$(top_srcdir) \
-I$(top_srcdir)/libnotify \
$(PACKAGE_CFLAGS)
-include $(top_srcdir)/git.mk

7
tools/meson.build
View File

@ -1,7 +0,0 @@
progs = ['notify-send']
foreach prog: progs
executable(prog, [prog + '.c'],
dependencies: libnotify_dep,
install: true)
endforeach

260
tools/notify-send.c
View File

@ -21,19 +21,16 @@
#include "config.h"
#include <libnotify/notify.h>
#include <locale.h>
#include <stdio.h>
#include <stdlib.h>
#include <string.h>
#include <glib.h>
#include <glib-unix.h>
#include <glib/gprintf.h>
#define N_(x) (x)
#define GETTEXT_PACKAGE NULL
static NotifyUrgency urgency = NOTIFY_URGENCY_NORMAL;
static GMainLoop *loop = NULL;
static gboolean
g_option_arg_urgency_cb (const char *option_name,
@ -101,26 +98,6 @@ notify_notification_set_hint_variant (NotifyNotification *notification,
key,
(guchar) h_byte);
}
} else if (g_ascii_strcasecmp (type, "boolean") == 0) {
gboolean h_boolean = FALSE;
if (g_ascii_strcasecmp (value, "true") == 0) {
h_boolean = TRUE;
} else if (g_ascii_isdigit (*value)) {
h_boolean = !!g_ascii_strtoull (value, NULL, 10);
}
notify_notification_set_hint (notification, key,
g_variant_new_boolean (h_boolean));
} else if (g_ascii_strcasecmp (type, "variant") == 0) {
GVariant *variant = g_variant_parse (NULL, value, NULL, NULL, NULL);
if (variant != NULL) {
notify_notification_set_hint (notification, key, variant);
} else {
conv_error = TRUE;
}
} else {
*error = g_error_new (G_OPTION_ERROR,
G_OPTION_ERROR_BAD_VALUE,
@ -142,91 +119,18 @@ notify_notification_set_hint_variant (NotifyNotification *notification,
return TRUE;
}
static void
handle_closed (NotifyNotification *notify,
gpointer user_data)
{
g_main_loop_quit (loop);
}
static gboolean
on_sigint (gpointer data)
{
NotifyNotification *notification = data;
g_printerr ("Wait cancelled, closing notification\n");
notify_notification_close (notification, NULL);
g_main_loop_quit (loop);
return FALSE;
}
static void
handle_action (NotifyNotification *notify,
char *action,
gpointer user_data)
{
const char *action_name = user_data;
const char *activation_token;
activation_token = notify_notification_get_activation_token (notify);
g_printf ("%s\n", action_name);
if (activation_token) {
g_debug ("Activation Token: %s", activation_token);
}
notify_notification_close (notify, NULL);
}
static gboolean
on_wait_timeout (gpointer data)
{
fprintf (stderr, "Wait timeout expired\n");
g_main_loop_quit (loop);
return FALSE;
}
static gboolean
server_has_capability (const gchar *capability)
{
GList *server_caps = notify_get_server_caps ();
gboolean supported;
supported = !!g_list_find_custom (server_caps,
capability,
(GCompareFunc) g_ascii_strcasecmp);
g_list_foreach (server_caps, (GFunc) g_free, NULL);
g_list_free (server_caps);
return supported;
}
int
main (int argc, char *argv[])
{
static const char *summary = NULL;
char *body;
static const char *type = NULL;
static char *app_name = NULL;
static char *icon_str = NULL;
static char *icons = NULL;
static char **n_text = NULL;
static char **hints = NULL;
static char **actions = NULL;
static char *server_name = NULL;
static char *server_vendor = NULL;
static char *server_version = NULL;
static char *server_spec_version = NULL;
static gboolean print_id = FALSE;
static gint notification_id = 0;
static gboolean do_version = FALSE;
static gboolean hint_error = FALSE, show_error = FALSE;
static gboolean transient = FALSE;
static gboolean wait = FALSE;
static gboolean hint_error = FALSE;
static glong expire_timeout = NOTIFY_EXPIRES_DEFAULT;
GOptionContext *opt_ctx;
NotifyNotification *notify;
@ -242,34 +146,16 @@ main (int argc, char *argv[])
N_
("Specifies the timeout in milliseconds at which to expire the "
"notification."), N_("TIME")},
{"app-name", 'a', 0, G_OPTION_ARG_STRING, &app_name,
N_("Specifies the app name for the icon"), N_("APP_NAME")},
{"icon", 'i', 0, G_OPTION_ARG_FILENAME, &icon_str,
{"icon", 'i', 0, G_OPTION_ARG_FILENAME, &icons,
N_("Specifies an icon filename or stock icon to display."),
N_("ICON")},
N_("ICON[,ICON...]")},
{"category", 'c', 0, G_OPTION_ARG_FILENAME, &type,
N_("Specifies the notification category."),
N_("TYPE[,TYPE...]")},
{"transient", 'e', 0, G_OPTION_ARG_NONE, &transient,
N_("Create a transient notification"),
NULL},
{"hint", 'h', 0, G_OPTION_ARG_FILENAME_ARRAY, &hints,
N_
("Specifies basic extra data to pass. Valid types are boolean, int, double, string, byte and variant."),
("Specifies basic extra data to pass. Valid types are int, double, string and byte."),
N_("TYPE:NAME:VALUE")},
{"print-id", 'p', 0, G_OPTION_ARG_NONE, &print_id,
N_ ("Print the notification ID."), NULL},
{"replace-id", 'r', 0, G_OPTION_ARG_INT, &notification_id,
N_ ("The ID of the notification to replace."), N_("REPLACE_ID")},
{"wait", 'w', 0, G_OPTION_ARG_NONE, &wait,
N_("Wait for the notification to be closed before exiting."),
NULL},
{"action", 'A', 0, G_OPTION_ARG_FILENAME_ARRAY, &actions,
N_
("Specifies the actions to display to the user. Implies --wait to wait for user input."
" May be set multiple times. The name of the action is output to stdout. If NAME is "
"not specified, the numerical index of the option is used (starting with 0)."),
N_("[NAME=]Text...")},
{"version", 'v', 0, G_OPTION_ARG_NONE, &do_version,
N_("Version of the package."),
NULL},
@ -281,10 +167,9 @@ main (int argc, char *argv[])
body = NULL;
setlocale (LC_ALL, "");
g_type_init ();
g_set_prgname (argv[0]);
g_log_set_always_fatal (G_LOG_LEVEL_ERROR | G_LOG_LEVEL_CRITICAL);
opt_ctx = g_option_context_new (N_("<SUMMARY> [BODY] - "
"create a notification"));
@ -321,43 +206,26 @@ main (int argc, char *argv[])
}
}
if (icons != NULL) {
char *c;
/* XXX */
if ((c = strchr (icons, ',')) != NULL)
*c = '\0';
icon_str = icons;
}
if (!notify_init ("notify-send"))
exit (1);
notify_get_server_info (&server_name,
&server_vendor,
&server_version,
&server_spec_version);
g_debug ("Using sever %s %s, v%s - Supporting Notification Spec %s",
server_name, server_vendor, server_version, server_spec_version);
g_free (server_name);
g_free (server_vendor);
g_free (server_version);
g_free (server_spec_version);
notify = g_object_new (NOTIFY_TYPE_NOTIFICATION,
"summary", summary,
"body", body,
"icon-name", icon_str,
"id", notification_id,
NULL);
notify = notify_notification_new (summary,
body,
icon_str,
NULL);
notify_notification_set_category (notify, type);
notify_notification_set_urgency (notify, urgency);
notify_notification_set_timeout (notify, expire_timeout);
notify_notification_set_app_name (notify, app_name);
if (transient) {
notify_notification_set_hint (notify, "transient",
g_variant_new_boolean (TRUE));
if (!server_has_capability ("persistence")) {
g_debug ("Persistence is not supported by the "
"notifications server. "
"All notifications are transient.");
}
}
g_free (body);
@ -369,7 +237,7 @@ main (int argc, char *argv[])
char **tokens = NULL;
while ((hint = hints[i++])) {
tokens = g_strsplit (hint, ":", 3);
tokens = g_strsplit (hint, ":", -1);
l = g_strv_length (tokens);
if (l != 3) {
@ -386,7 +254,7 @@ main (int argc, char *argv[])
if (!retval) {
fprintf (stderr, "%s\n", error->message);
g_clear_error (&error);
g_error_free (error);
hint_error = TRUE;
}
}
@ -397,90 +265,12 @@ main (int argc, char *argv[])
}
}
if (actions != NULL) {
gint i = 0;
char *action = NULL;
gchar **spl = NULL;
gboolean have_actions;
have_actions = server_has_capability ("actions");
if (!have_actions) {
g_printerr (N_("Actions are not supported by this "
"notifications server. "
"Displaying non-interactively.\n"));
show_error = TRUE;
}
while (have_actions && (action = actions[i++])) {
gchar *name;
const gchar *label;
spl = g_strsplit (action, "=", 2);
if (g_strv_length (spl) == 1) {
name = g_strdup_printf ("%d", i - 1);
label = g_strstrip (spl[0]);
} else {
name = g_strdup (g_strstrip (spl[0]));
label = g_strstrip (spl[1]);
}
if (*label != '\0' && *name != '\0') {
notify_notification_add_action (notify,
name,
label,
handle_action,
name,
g_free);
wait = TRUE;
}
g_strfreev (spl);
}
g_strfreev (actions);
}
if (wait) {
g_signal_connect (G_OBJECT (notify),
"closed",
G_CALLBACK (handle_closed),
NULL);
if (expire_timeout > 0) {
g_timeout_add (expire_timeout, on_wait_timeout, NULL);
}
}
if (!hint_error) {
retval = notify_notification_show (notify, &error);
if (!retval) {
fprintf (stderr, "%s\n", error->message);
g_clear_error (&error);
show_error = TRUE;
}
}
if (print_id) {
g_object_get (notify, "id", &notification_id, NULL);
g_printf ("%d\n", notification_id);
}
if (wait) {
g_unix_signal_add (SIGINT, on_sigint, notify);
loop = g_main_loop_new (NULL, FALSE);
g_main_loop_run (loop);
g_main_loop_unref (loop);
loop = NULL;
}
if (!hint_error)
notify_notification_show (notify, NULL);
g_object_unref (G_OBJECT (notify));
notify_uninit ();
if (hint_error || show_error)
exit (1);
return 0;
exit (hint_error);
}