Compare commits

..

190 Commits
0.5 ... master

Author SHA1 Message Date
Andre Klapper 80121a3b8c docs: Fix URL to Desktop Notification Spec
Fixes #29
2022-09-04 11:59:49 +02:00
Marco Trevisan (Treviño) 650f2f123e
Releasing version 0.8.1
Update NEWS.
2022-07-17 15:00:39 +02:00
Marco Trevisan (Treviño) a8374698c4 build: Hardcode API version to 0.7
Fixes: #27
2022-07-17 14:58:13 +02:00
Marco Trevisan (Treviño) 359443f70f
Releasing version 0.8.0
Update NEWS.
2022-07-14 17:18:41 +02:00
Marco Trevisan (Treviño) 3d81394cd2 NEWS: Fix style on previous announcement 2022-07-14 17:18:25 +02:00
Marco Trevisan (Treviño) 5e6a52fa4f README: Add reference to Portal Notification APIs 2022-06-07 03:18:38 +02:00
Marco Trevisan (Treviño) 532608248e build: Pre-release bump to 0.8.0 2022-06-07 03:18:38 +02:00
Marco Trevisan (Treviño) adb3e0c7bf notification: Warn if trying to get the activation token outside activation
This API is intended to be used only during a NotifyActionCallback, so
ensure that this is the case, by warn in case it's not the case.
2022-06-07 03:18:38 +02:00
Marco Trevisan (Treviño) 13718b6ea0 notify: Also try to use the flatpak app name as notify app 2022-06-07 03:18:38 +02:00
Marco Trevisan (Treviño) f3eb807464 notification: Use Desktop Portal notification when running in sandbox
When an application is running from a snap or a flatpak, libnotify
should just work as a FDO Portal Notification wrapper.

As per this, make the library to try use the portal API in sandboxed
applications, by emulating the needed missing pieces.

Not everything can be achieved 1:1, but it's just safer to use in such
contexts.
2022-06-07 03:18:38 +02:00
Marco Trevisan (Treviño) c6534a144c build: Bump dependency on glib 2.38
It's almost 10 years old, so I think we can safely depend on that to
support the features we're optionally depending on, plus the ones we're
going to add
2022-06-07 03:18:38 +02:00
Marco Trevisan (Treviño) 543d636153 notification: Move action activation and closing in separate functions
Move handling of such events in different functions so that can be
re-used
2022-06-07 03:18:38 +02:00
Marco Trevisan (Treviño) 9e9cb423b9 Notification: Add NotifyClosedReason enum to define closed reasons
We don't change the formal type of notify_notification_get_closed_reason
but it's safe enough to compare the two returned values.
2022-06-07 03:18:38 +02:00
Marco Trevisan (Treviño) cc30d8b8dd notify: Support passing a NULL application name to notify_init()
We can find its name in some scenarios, so make it clearer from in the API.

Also, ensure that notify_set_app_name() is not used with a NULL App
name.
2022-06-07 03:18:38 +02:00
Marco Trevisan (Treviño) e8ea0c39d0 notify: Use lazy snap readings and once per notify instance
An application under snap confinement won't have a way of escaping from
it, so we can just initialize the snap variables at the global notify
scope once and just re-use them when needed.
2022-06-07 03:18:38 +02:00
Marco Trevisan (Treviño) 74f87250a3 notify-send: Handle Ctrl+C by closing the notification before exiting
Avoid leaving notifications we're waiting for around on SIGNINT
2022-06-07 03:18:38 +02:00
Marco Trevisan (Treviño) 07a2b2e32c notify-send: Add debug logs about the notification daemon 2022-06-07 03:18:38 +02:00
Marco Trevisan (Treviño) 8ce5daac4f notification: Add docs description for NotifyNotification 2022-06-07 03:18:38 +02:00
Marco Trevisan (Treviño) 9d28fa3600 notification: Document get_activation_token argument 2022-06-07 03:18:38 +02:00
Marco Trevisan (Treviño) 4e40a460ce notification: Fix documentation and transfer info for NotifyActionCallback 2022-06-07 03:18:38 +02:00
Logan Rathbone 8162b1d397 Bump version to 0.7.12
Update NEWS.
2022-05-05 12:03:27 -04:00
Logan Rathbone 4d68baf5ef Merge branch 'fix-electron-crash' into 'master'
Closes #25

See merge request GNOME/libnotify!26
2022-05-05 02:10:25 +00:00
Logan Rathbone 596d09a78f notification: Bookend calling NotifyActionCallback with temporary ref
Starting with d0778595, we access the Notification object after the
NotifyActionCallback; some clients (eg, Electron) have historically
unref'd the object at the end of the NotifyActionCallback. They probably
should not have been doing so, but this hotfix adds an additional ref
before and after the callback so that we don't break existing code.

Fixes #25
2022-05-04 21:04:25 -04:00
Logan Rathbone f5b9619b2f doap: Add self as co-maintainer; remove chammond and mccann
Per:
- Discussions on #release-team
- No response to email to mccann in over 10 days
- Email response from chammond confirming he should no longer be listed
  as maintainer

See also: afef1e98
Closes: #14
2022-05-04 11:36:37 -04:00
Marco Trevisan (Treviño) afef1e98b3 Adding myself as maintainer
As discussed on #release-team:

  21:12:18 <ebassi> Trevinho: You could already add yourself to the DOAP file
2022-05-04 16:22:23 +02:00
Marco Trevisan (Treviño) ecb1d4ec08 libnotify.doap: Add missing description field 2022-05-04 16:22:23 +02:00
Patrick Griffis 6d8e38bc69 Merge branch 'pgriffis/delete-unused-file' into 'master'
Delete unused notifynotification.xml

See merge request GNOME/libnotify!25
2022-05-03 20:37:41 +00:00
Patrick Griffis 6e6d52340b Delete unused notifynotification.xml 2022-05-03 20:35:50 +00:00
Marco Trevisan (Treviño) 1fba04bc03 notification: Include sender-pid hint by default if not provided
It's used by various daemons including GNOME Shell to figure out the
parent application.
2022-04-28 01:06:58 +02:00
Marco Trevisan (Treviño) a674e610ee notify-send: Add debug message about server not supporting persistence
In case a transient notification is requested but persistence is not
supported, it's not an error but it is useful to show a debug message
to clarify that.
2022-04-27 21:32:56 +02:00
Marco Trevisan (Treviño) c99aacdb91 notify-send: Move server capabilities check to a separate function 2022-04-27 21:32:30 +02:00
Marco Trevisan (Treviño) 997115b459 docs/notify-send: Add --transient option to manpage 2022-04-27 21:25:10 +02:00
Marco Trevisan (Treviño) e8a57f7245
Bump version to 0.7.11
Update NEWS.
2022-04-27 21:05:49 +02:00
Marco Trevisan (Treviño) ed43da3479 notify-send: Add explicit option to create transient notifications 2022-04-27 20:52:48 +02:00
Marco Trevisan (Treviño) 02f2f91c3d notify-send: Support passing any hint value, by parsing variant strings 2022-04-27 20:45:06 +02:00
Marco Trevisan (Treviño) d6f4734adf notify-send: Add support for boolean hints
Boolean hints are used for some common parameters such as "transient".

Original bug: https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=636343
2022-04-27 20:33:40 +02:00
Marco Trevisan (Treviño) 6e871a4047 cleanup: Do not use GLIB_CHECK_VERSION
It's not supported by GLib 2.26.0, the minimum version we required
2022-04-27 20:18:48 +02:00
Marco Trevisan (Treviño) 59553a5af2 NEWS: Add --wait feature to last release 2022-04-27 20:16:49 +02:00
Marco Trevisan (Treviño) 2674c76f53
Bump version to 0.7.10
Update NEWS.
2022-04-27 19:00:44 +02:00
Marco Trevisan (Treviño) d138596c78 CI: Also install the built files and expose docs and logs 2022-04-27 18:29:47 +02:00
Marco Trevisan (Treviño) d07785959c notification: Add support for getting actions activation token
Notification actions can now be activated with an activation token
containing platform data. So update the notification-spec to include
latest version of the specification, and expose the activation token
during an action activation.

Not to change the API, by modifying the type of NotifyActionCallback
it's just better to provide a function to fetch the activation token
during activation only, so that this can be retro-compatible.

Reference: https://gitlab.freedesktop.org/xdg/xdg-specs/-/commit/b9a4700
2022-04-27 18:02:20 +02:00
Marco Trevisan (Treviño) 47400a2ff7 notify-send: Clear errors that could be re-used
We're using error variable multiple times, and this may lead to problems
when trying to set it again. So let's just clear once it's used.
2022-04-25 22:23:40 +02:00
Marco Trevisan (Treviño) 1da6996491 notify: Use the application ID if available to set the fallback app name 2022-04-25 22:23:40 +02:00
Ben Blain e05030875e docs/notify-send: Add missing --app-name description to manual 2022-04-25 22:23:40 +02:00
Ben Blain 12d4b90623 notify-send: Check for notification server actions capability support 2022-04-25 22:23:40 +02:00
Ben Blain 6c707d2dfd notify-send: Add support for notification actions and responses
The activated action name is written to stdout and the notification is closed
when a valid action has been selected.
2022-04-25 22:23:37 +02:00
Ben Blain a396dd9af9 notify-send: Add option to wait until notification has been closed
If an expiration timeout is set, the notification is not waited longer
than such time.
2022-04-25 22:15:50 +02:00
Matthias Sweertvaegher 00a7e74774 docs/notify-send: Add print/replace-id arguments to man page 2022-04-25 19:43:12 +02:00
Paul Collins 652b4d6911 notify-send: Support for replacing an existing notification
Support printing and overriding notification ID, so that it's possible
to replace a notification that is currently showing with an updated
content.

Based on patch as provided by Paul Collins in the following bug
report:
  https://bugs.launchpad.net/ubuntu/+source/libnotify/+bug/257135/comments/8

Co-authored-by: Marco Trevisan (Treviño) <mail@3v1n0.net>

Fixes #19
2022-04-25 19:42:13 +02:00
Marco Trevisan (Treviño) f9c1cf1b71 notification: Keep converted URIs as such when we prepend a path 2022-04-25 19:13:22 +02:00
Marco Trevisan (Treviño) 997e2e374a notification: Do not duplicate calls on parse functions 2022-04-25 19:13:22 +02:00
Marco Trevisan (Treviño) 0d86d8c8d5 notification: Improve debug logs when rewriting paths 2022-04-25 19:13:22 +02:00
Marco Trevisan (Treviño) b2d6712b15 notification: Avoid creating a new hint variant when nothing has changed 2022-04-25 19:13:22 +02:00
Marco Trevisan (Treviño) 961f45f44c notification: Use snap name and app name as fallback desktop-entry
Snaps use desktop IDs based on the snap name and the application name
inside the snap, so if we're in a such container, we need to compute the
desktop-entry using those values. We can figure them out from the snap
cgroup they're in.

In such case, don't even try to use the GApplication ID as that is
likely wrong in a snapped environment.
2022-04-25 19:13:22 +02:00
Marco Trevisan (Treviño) e72396e8ca notification: Preserve snap details into the private struct
We may need to use them in various places, so there's no point to repeat
the same in multiple places, this way we can also use some shortcuts for
non-snap setups.
2022-04-25 19:13:22 +02:00
Marco Trevisan (Treviño) d21b8140a8 notification: Do not try to append snap name to desktop when it's a path 2022-04-25 19:13:22 +02:00
Marco Trevisan (Treviño) c4d5ea8baf notification: Do not prepend SNAP prefix when is already present
We used to just add it again, to eventually figure out that the file
did not exists, but may not work properly in some scenarios.

Also always fill the path_filename when using a file-name only, as that
may be refer to something under the SNAP path, and in such case we want
to try check if that exists before giving up.
2022-04-25 19:13:22 +02:00
Marco Trevisan (Treviño) d348a36a05 build: Do not require g-ir-scanner on introspection=auto 2022-04-21 23:53:44 +02:00
Marco Trevisan (Treviño) d5a888fa31 notification: Use g_memdup2 when available
It's not really an issue here, as we use a properly typed len, but
better not to use a deprecated and potentially dangerous API.
2022-04-21 23:53:44 +02:00
Marco Trevisan (Treviño) 736fcea1d0 build: Avoid warnings or mis-behavior in recent meson versions
In future meson will check the run_command result by default, while it's
fine for us, it would cause our nicer error message not to work.
2022-04-21 23:53:44 +02:00
Marco Trevisan (Treviño) 2accd4ceab Revert "Revert "Merge branch 'readme' into 'master'""
This reverts commit 1ad4630107.

As per: https://gitlab.gnome.org/GNOME/libnotify/-/commit/1ad46301#note_1434358
2022-04-21 18:51:13 +02:00
Corentin Noël 333f7c5d32 Send the application ID when possible 2022-04-21 16:35:38 +02:00
David King 7f31e29e62 docs: Use consistent IDs in spec build
This avoids differences between IDs for separate builds of the
specification.
2022-04-21 14:37:58 +02:00
Logan Rathbone 1ad4630107 Revert "Merge branch 'readme' into 'master'"
This reverts merge request !21
2022-03-21 22:19:32 +00:00
Logan Rathbone e35921f10f Merge branch 'readme' into 'master'
Add README clarifying status of libnotify

See merge request GNOME/libnotify!21
2022-03-21 22:15:16 +00:00
Maximiliano Sandoval R edb1dc8394
Add README clarifying status of libnotify
See discussions at https://gitlab.gnome.org/GNOME/libnotify/-/issues/20.

Based off https://gitlab.gnome.org/GNOME/libnotify/-/merge_requests/19
2022-03-14 17:50:55 +01:00
Ray Strode a228f1e84d notify-send: Give failing exit code if showing notification fails
Right now notify-send will quietly return a successful exit status
even if showing the notification fails.

This commit changes the behavior to instead fail on failure.

https://gitlab.gnome.org/GNOME/libnotify/-/merge_requests/13
2021-05-14 13:55:53 -04:00
Marco Trevisan 05112e2a5b Merge branch 'update_documenation' into 'master'
Update documenation (generated man file) to express that plasma notification...

See merge request GNOME/libnotify!14
2021-04-06 11:59:19 +00:00
Alberts Muktupāvels 39575f7c6f Merge branch 'master' into 'master'
notify-send: Support commas in icon filenames

See merge request GNOME/libnotify!15
2021-03-26 15:57:33 +00:00
Thorsten Wißmann dfaa76109e notify-send: Support commas in icon filenames
Do not cut off an icon filename (passed to -i) at the first comma
character. The original motivation probably was to support a list of
icon names in -i separated by comma. However, this has never been
implemented and the help text for -i also only mentions "an icon".

Hence, no functionality is lost by this change. In contrast, -i now
supports commas in icon filepaths.

https://gitlab.gnome.org/GNOME/libnotify/-/issues/16
2021-03-26 16:52:49 +01:00
Alberts Muktupāvels 48e64c39bc Merge branch 'fix-ci' into 'master'
fix CI build stuck on TZ data config

See merge request GNOME/libnotify!16
2020-12-24 18:34:29 +00:00
Matthias Sweertvaegher 698a05fcc4 fix CI build stuck on TZ data config
when pushing a new commit, I noticed the CI build gets stuck on:

Configuring tzdata
------------------
Please select the geographic area in which you live. Subsequent configuration
questions will narrow this down by presenting a list of cities, representing
the time zones in which they are located.
  1. Africa   3. Antarctica  5. Arctic  7. Atlantic  9. Indian    11. US
  2. America  4. Australia   6. Asia    8. Europe    10. Pacific  12. Etc
Geographic area:
2020-12-14 17:44:11 +01:00
Boris Shtrasman 50cf335a34 Take Marco Trevisan text enhencment 2020-09-17 20:52:37 +03:00
Boris Shtrasman 4e2971be0c enhence text 2020-09-01 16:03:03 +03:00
Boris Shtrasman d9ba514b15 Update documenation (generated man file) to express that plasma notification system will ignore timeout value when level is in critical mode 2020-08-31 21:56:54 +03:00
Marco Trevisan (Treviño) 98a4bf483a release: 0.7.9 2020-02-26 20:06:01 +01:00
Marco Trevisan d30f73d628 Merge branch 'wip/jtojnar/manpage' into 'master'
Add notify-send manpage

Closes #4

See merge request GNOME/libnotify!6
2020-01-13 17:15:51 +00:00
Marco Trevisan ea61ec4301 Merge branch 'snap-paths-support' into 'master'
notification: use snap namespace and prefix whent launched inside snap

See merge request GNOME/libnotify!5
2020-01-13 17:11:47 +00:00
Marco Trevisan b95d41283e Merge branch 'wip/jtojnar/drop-autotools' into 'master'
Drop Autotools

See merge request GNOME/libnotify!11
2020-01-13 17:10:31 +00:00
Jan Tojnar edfd97f4a9
ci: Do not pass default flags to meson 2020-01-13 17:12:00 +01:00
Jan Tojnar a599a04de6
Drop Autotools 2020-01-13 17:09:17 +01:00
Jan Tojnar 162d195869
Add notify-send manpage
Taken from Debian, converted to Docbook and fixed some issues.

Closes: https://gitlab.gnome.org/GNOME/libnotify/issues/4
2020-01-13 16:41:31 +01:00
Iain Lane 2e8ed8add3 notification: Handle snap applications
When a non-relocatable application is packaged as a snap, its resources
will be visible under `${SNAP}`. We can discover these resources by
probing paths that are given to us and trying the same path under
`${SNAP}` if the probe fails.

Snap packages have desktop files namespaced by the snap name. This name
is available inside the snap environment as `${SNAP_NAME}`. Also probe
desktop files and try this form of mangled name if the referenced
desktop file is not found.
2019-08-14 15:43:43 +02:00
Jan Tojnar 55eb69247f
build: check supported linker args before build
MacOS linker does not support --version-script argument so we need
to only add it to ldflags when it is available.
2019-04-26 20:20:22 +02:00
Florian Müllner 44f9222212 Bump version to 0.7.8
Update NEWS.
2019-03-28 19:24:26 +01:00
Florian Müllner f5a845dd00 build: Don't use absolute path with 'subdir' keyword
Newer meson versions expect a relative path (to the includedir option)
there and reject passing an absolute path.

https://gitlab.gnome.org/GNOME/libnotify/merge_requests/8
2019-03-28 19:06:26 +01:00
Iain Lane d3277ac331 Merge branch 'notify-send-support-file-proto' into 'master'
notify-send: allow passing colon as hint value

See merge request GNOME/libnotify!4
2019-02-15 13:35:36 +00:00
Marco Trevisan (Treviño) 9862ab85e8
notify-send: allow passing colon as hint value
While some hints like image-path or sound-file supports parameters using the
file:// protocol, it's impossible to pass such hints to notify-send, because
it splits the passed argument so that it can have an unlimited number of colons,
while only 3 should be there (as per TYPE:NAME:VALUE format).

So, make `g_strsplit` to accept only 3 tokens as maximum, while pass the
remaining parameters all-together.

So now it's possible to do
  notify-send -h string:image-path:file:///usr/share/icons/foo.png
2019-02-15 12:54:39 +00:00
Abderrahim Kitouni 3f71a3b3ba meson.build: fix pkg-config generation
The code was previously using glib_dep.version() as a version for gio which
generates an invalid version like "gio-2.0 2.59.1" in the pkg-config file.
2019-02-01 14:21:14 +01:00
Marco Trevisan b7351a39fb Merge branch 'wip/3v1n0/meson' into 'master'
Build with meson and add CI

See merge request GNOME/libnotify!3
2019-01-31 17:15:27 +00:00
Marco Trevisan 593f260722 Build with meson and add CI 2019-01-31 17:15:27 +00:00
Jan Tojnar a1bedfa65e
docs: Fix spec build
Correct DTD and add config.xsl to EXTRA_DIST
2019-01-26 10:44:22 +01:00
Emmanuele Bassi 43aac613f1 Conditionall call g_type_init() after a version check
There's no need to call g_type_init() since GLib 2.36, so let's hide it
when building against newer versions of GLib.
2017-07-17 10:16:06 +01:00
Emmanuele Bassi 46e8b1cfad build: Update the list of headers in srcdir
The generated notify-features.h header lives in builddir, which means it
does not exist in srcdir, where glib-mkenums will look. It also contains
pre-processor symbols only, so it's not really useful.

As we removed it from the list of headers to be scanned by the
introspection parser, we also need to update the files rules for that.
2017-07-17 10:11:48 +01:00
Ting-Wei Lan 5398ecfe3f notify-send: Call setlocale in main function
It is required to correctly show translated messages on some locales.

https://bugzilla.gnome.org/show_bug.cgi?id=760438
2016-10-22 11:32:36 +08:00
Cosimo Cecchi c954cabaad release: prepare for 0.7.7 2016-10-13 15:44:18 -07:00
Quentin Glidic 6b03c47e04 build: Use ${PKG_CONFIG} instead of pkg-config
Some use cases (e.g. cross-compiling) require a prefixed pkg-config

https://bugzilla.gnome.org/show_bug.cgi?id=758322

Signed-off-by: Quentin Glidic <sardemff7+git@sardemff7.net>
2016-06-14 16:07:31 +02:00
Quentin Glidic da7a6a229b build: Allow not to build tests
https://bugzilla.gnome.org/show_bug.cgi?id=634790

Signed-off-by: Quentin Glidic <sardemff7+git@sardemff7.net>
2016-06-14 16:07:31 +02:00
Andre Klapper 2f2c5649ef doap: add <programming-language> 2014-08-01 23:32:16 +02:00
Olav Vitters dafa138886 doap category core 2014-07-30 20:31:31 +02:00
Evan Nemerson da49c8c599 NotifyNotification: fix set_hint_byte_array value annotation
https://bugzilla.gnome.org/show_bug.cgi?id=667904
2014-04-01 21:19:01 +02:00
Evan Nemerson 5a486c5490 Include C header information and exported packages in GIR
https://bugzilla.gnome.org/show_bug.cgi?id=667904
2014-04-01 21:02:56 +02:00
Ryan Lortie fc6cba771d Remove INSTALL from version control
This is getting updated by autoregen causing jhbuild to mistakenly
believe that the build is dirty.
2014-02-25 15:21:50 -05:00
Matthias Clasen f9355ca357 0.7.6 2013-09-02 21:47:23 -04:00
Giovanni Campagna 2b4ab4d22f NotifyNotification: fix annotation for add_action()
Using GFreeFunc instead of GDestroyNotify was a mistake, but
(scope async) is even a bigger mistake (one that can crash apps,
if an action is invoked multiple times)

https://bugzilla.gnome.org/show_bug.cgi?id=702390
2013-09-02 21:42:37 -04:00
Matthias Clasen 9128042026 Clarify docs of notify_notification_set_timeout
In response to
https://bugzilla.gnome.org/show_bug.cgi?id=701645
2013-06-07 20:28:10 -04:00
Matthias Clasen 6982957661 Bump version 2012-03-26 22:01:28 -04:00
Matthias Clasen 20721a3351 0.7.5 2012-03-26 22:00:54 -04:00
Colin Walters 5e3654b70b build: Also fix introspection when srcdir != builddir 2012-01-16 18:47:31 -05:00
Colin Walters b6e1f7f1a2 build: Another srcdir != builddir fix 2012-01-16 18:44:49 -05:00
Colin Walters bc612b9fc8 build: Fix srcdir != builddir 2012-01-16 18:42:58 -05:00
Jasper St. Pierre b873c61ecc notify-send: Add ability to set app name 2011-10-12 17:31:29 -04:00
Javier Jardón 6a63ae0e8a libnotify-sections.txt: Add some missing api 2011-10-09 13:16:07 -04:00
Javier Jardón 2fe1748295 notification.h: Add deprecation guards 2011-10-09 13:08:53 -04:00
Javier Jardón 34aa27f600 libnotify-docs.sgml: Add list of all and deprecated symbols 2011-10-09 12:56:25 -04:00
Matthias Clasen bd385da02a More D-Bus type clarifications
Only use conventional names where they uniquely identify
the wire type, and type signatures elsewhere. This replaces
DICT by a{sv}
ARRAY by as
STRING_ARRAY by as
2011-09-05 08:55:08 -04:00
Matthias Clasen 3a60c433fd Spec: Clarify types of hints
Most type names were clear, but 'int' could map to different
dbus types. Use conventional D-Bus type names througout.
2011-09-05 08:31:58 -04:00
Matthias Clasen f6638ebfb7 Post-release version bump 2011-08-27 18:56:22 -04:00
Matthias Clasen edfabdf078 0.7.4 2011-08-27 18:55:36 -04:00
William Jon McCann e8ecbfb036 Add simple test for notification removal 2011-06-16 14:46:52 -04:00
Javier Jardón 11d46bf9fd configure.ac: AC_SUBST "pkg_modules" as Its needed to generate the .pc file
This fixes commit fb7790f5b4
2011-05-04 07:04:26 +01:00
Javier Jardón fb7790f5b4 build: Update autotools configuration
Replace deprecated autoconf macros and use the new libtool syntax
2011-05-03 13:47:36 -04:00
Craig Keogh a5ad7b6063 Honor aclocal flags (GNOME bug 641461) 2011-05-03 13:43:55 -04:00
Colin Walters 52cb20bb53 spec: Explicitly document components of on image data
Since we're just passing it ultimately to gdk_pixbuf_new_from_data in
the server, we really should be documenting the restrictions here, such
as bits_per_sample always being 8.

https://bugzilla.gnome.org/show_bug.cgi?id=647672
2011-05-03 13:41:43 -04:00
Matthias Clasen d12145208a Update 2011-05-02 23:40:13 -04:00
Richard Hughes 1c40dfaff4 Add notify_notification_set_app_name() to set the application name for the notification
When a daemon like gnome-settings-daemon has multiple plugins, if a plugin uses
notify_set_app_name() then subsequent notifications get the wrong
'Application name' in the gnome-shell persistent message tray.

This new function is per-notification and is thus allows us to set a custom
application name without overwriting the application name stored by notify_init().

https://bugzilla.gnome.org/show_bug.cgi?id=648947
2011-05-02 23:36:52 -04:00
Matthias Clasen ae361b0d96 Bump version 2011-03-21 19:43:52 -04:00
Matthias Clasen 00203dda48 Really bump version 2011-03-21 19:39:34 -04:00
Matthias Clasen 9fd7ac3008 Update NEWS for 0.7.2 2011-03-21 19:33:03 -04:00
Matthias Clasen 10ea1f0e65 Allow properties to be set in any order
The code as written needlessly required summary to be set first.
https://bugzilla.gnome.org/show_bug.cgi?id=645222
2011-03-20 23:51:55 -04:00
William Jon McCann cdc6f37dd8 Add another test with symbolic icons 2011-03-15 00:09:25 -04:00
Olav Vitters b73380b586 DOAP: Fix userid 2011-01-28 16:14:24 +01:00
William Jon McCann 9fae742d43 Mark image_path as deprecated 2011-01-17 17:02:27 -05:00
William Jon McCann b20752a2e5 Use - instead of _ in hint names consistently 2011-01-17 16:57:31 -05:00
William Jon McCann a967c61e5b Add a way to set or change the application name
May be useful for presenting different message sources
within a single process.
2011-01-17 16:40:17 -05:00
Matthias Clasen 277f40c872 Bump version 2011-01-14 17:14:54 -05:00
Matthias Clasen ac3b072c74 Update NEWS for 0.7.1 2011-01-14 17:05:15 -05:00
Emilio Pozuelo Monfort 9d5e8582b3 Don't export private symbols in the shared library
https://bugzilla.gnome.org/show_bug.cgi?id=635958
2011-01-11 23:33:13 +00:00
Martin Pitt b2020b7f2a Add Python test script for GIR
https://bugzilla.gnome.org/show_bug.cgi?id=635169
2010-11-18 14:21:10 +01:00
Martin Pitt d3de00c14e Some more missing GIR annocations
https://bugzilla.gnome.org/show_bug.cgi?id=635169
2010-11-18 14:05:48 +01:00
Jonathan Matthew 2b6e827092 Generate gir and typelib for gobject-introspection 2010-11-18 00:13:14 -05:00
Jonathan Matthew 84958a7acb Fix some annotations 2010-11-18 00:11:29 -05:00
William Jon McCann 5e9614637d Make actions test more like a real scenario 2010-11-15 14:57:03 -05:00
William Jon McCann ff1941aa9e Make notify-send always die on warnings 2010-11-15 14:56:32 -05:00
William Jon McCann 54b6285006 Don't set NULL hint strings 2010-11-15 14:44:40 -05:00
William Jon McCann e6a4970a79 return NULL not FALSE 2010-11-15 14:41:25 -05:00
William Jon McCann ef744d75d0 Show a warning and assert if notify_init isn't called before show 2010-11-15 12:44:32 -05:00
William Jon McCann 1b33c07973 Remove function annotations from notify.h 2010-11-14 11:07:53 -05:00
Javier Jardón 2ae1dadfa9 docs: Some fixes
https://bugzilla.gnome.org/show_bug.cgi?id=634266
2010-11-14 11:00:57 -05:00
Javier Jardón 7d64b2b514 docs: Update libnotify-sections.txt
https://bugzilla.gnome.org/show_bug.cgi?id=634266
2010-11-14 10:52:47 -05:00
Javier Jardón 3acf1c14e0 docs: Do not generate template files
As we use inline comments now

https://bugzilla.gnome.org/show_bug.cgi?id=634266
2010-11-14 10:52:45 -05:00
Javier Jardón 560abf5c97 docs: Move documentation to inline comments: notify
https://bugzilla.gnome.org/show_bug.cgi?id=634266
2010-11-14 10:52:42 -05:00
Javier Jardón abb884af73 docs: Move documentation to inline comments: notification
https://bugzilla.gnome.org/show_bug.cgi?id=634266
2010-11-14 10:52:38 -05:00
William Jon McCann 59b6bff174 Use LGPL file header
Mistakenly used a GPL license header.
2010-11-14 10:42:10 -05:00
Guillaume Desmottes 49766bca28 notify_notification_set_image_from_pixbuf: ref the pixbuf (#633829) 2010-11-02 17:02:37 +01:00
William Jon McCann a096a24337 Add a negative case to the action-icons test 2010-10-29 19:07:21 -04:00
William Jon McCann 8ae0b6e908 Add test for action-icons 2010-10-29 18:32:46 -04:00
William Jon McCann 1fdab39d65 [spec] Add action-icons hint and server capability
https://bugzilla.gnome.org/show_bug.cgi?id=633510
2010-10-29 18:17:11 -04:00
William Jon McCann 714c29afcc Enhance the resident test 2010-10-29 18:16:31 -04:00
William Jon McCann 4026faf46b Add tests for transient and resident 2010-10-28 14:55:08 -04:00
William Jon McCann 4fa4cedd2e Remove some outdated text in abstract 2010-10-28 14:33:36 -04:00
William Jon McCann dfcf661b80 Add spec versions to transient and resident hints 2010-10-28 14:29:15 -04:00
William Jon McCann a0bab8e3d0 Bump spec version and update authors 2010-10-28 14:26:33 -04:00
William Jon McCann 31dd7c3f7c Add transient hint
https://bugzilla.gnome.org/show_bug.cgi?id=633312
2010-10-28 14:21:59 -04:00
William Jon McCann 015131721c Add persistence server capability 2010-10-28 14:19:32 -04:00
William Jon McCann 487297e072 Add resident hint to the spec.
https://bugzilla.gnome.org/show_bug.cgi?id=633313
2010-10-28 14:14:09 -04:00
William Jon McCann 5a41ef5a09 Post release bump 2010-10-16 22:13:04 -04:00
William Jon McCann fb53f2b8f6 Add news 2010-10-16 22:11:13 -04:00
William Jon McCann 5b1a862c59 Bump version and .so number 2010-10-16 19:16:03 -04:00
William Jon McCann d82ad1b225 Remove silly old dbus version comments in the docs 2010-10-15 00:14:24 -04:00
William Jon McCann cff2c03c51 use the non-deprecated api in the test 2010-10-15 00:13:14 -04:00
William Jon McCann 0c34eb565e Use a less hacky way to get a stock pixbuf 2010-10-15 00:11:58 -04:00
Christian Persch f63e8ab8b1 Port to gdbus
Bug #622891.
2010-10-12 15:57:33 +02:00
William Jon McCann ccff2c5b24 Oops forgot to post release version bump 2010-10-11 23:39:06 -04:00
William Jon McCann f4e06fb372 Replace missing AC_SUBST to fix .pc file 2010-10-09 02:19:31 -04:00
William Jon McCann db7eb0180c Use notify-features.h instead of features.h 2010-10-09 01:26:38 -04:00
William Jon McCann cb6f92ce5b Port to gtk3 for the tests 2010-10-09 01:26:38 -04:00
William Jon McCann b6c1835fcf Don't need to fuss with gtk symbols since we don't use gtk at all anymore 2010-10-09 00:32:31 -04:00
William Jon McCann 7acabe0741 Add a macro for determining the version of the library 2010-10-08 23:29:30 -04:00
William Jon McCann 27e05d0f95 Remove the ability to attach notifications to widgets or positions 2010-10-08 22:47:06 -04:00
William Jon McCann 3f14ad4c71 Remove the ability to attach to a status icon
This technique is replaced by the use of notification persistence.
2010-10-08 22:31:40 -04:00
William Jon McCann 8c180aa49e Add a test for the persistence server capability 2010-10-08 21:29:28 -04:00
William Jon McCann 2c8d865b4f Prepare NEWS for release 2010-10-02 02:20:21 -04:00
William Jon McCann f56ef989e7 Remove obsolete dbus define 2010-10-02 02:20:03 -04:00
Jonny Lamb 4830863bab 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
2010-07-01 20:46:04 -04:00
William Jon McCann d69f0a2c83 Unstable branch is now at 0.6 2010-07-01 20:42:20 -04:00
Martin Pitt 1a103f1eee 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
2010-07-01 14:32:57 +02:00
Bastien Nocera c8d987d5f2 Post release version bump 2010-06-29 14:53:52 +01:00
Bastien Nocera c56f4855b1 0.5.1 2010-06-29 14:51:11 +01:00
Bastien Nocera 0eb56b2fcf Don't link against a particular version of GTK+
Instead, open ourselves through GModule, and check whether
we have all the GTK+ and GDK functions required for us to
work correctly.

This means that the front-end application cannot rely on
libnotify linking against GTK+, which would only be a problem
for edge-cases.

https://bugzilla.gnome.org/show_bug.cgi?id=622550
2010-06-28 23:34:50 +01:00
69 changed files with 3254 additions and 3499 deletions

37
.gitlab-ci.yml Normal file
View File

@ -0,0 +1,37 @@
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
View File

@ -1,984 +0,0 @@
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
View File

@ -1,229 +0,0 @@
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.

View File

@ -1,46 +0,0 @@
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,11 +1,165 @@
NEW in 0.5.2:
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:
==============
Note that the 0.5.1 release was released from the 0.6 branch in error.
Sorry about that.
- Add a way to change the application name for
individual notifications (Richard Hughes)
- Fixed #623096, Use correct variable in NULL check
- Added a macro NOTIFY_CHECK_VERSION
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
NEW in 0.5.0:
==============

0
README
View File

20
README.md Normal file
View File

@ -0,0 +1,20 @@
# 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

View File

@ -1,22 +0,0 @@
#!/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 Normal file
View File

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

View File

@ -1,232 +0,0 @@
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}
"

View File

@ -1,25 +0,0 @@
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

View File

@ -3,4 +3,5 @@
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 Normal file
View File

@ -0,0 +1,40 @@
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

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.1</releaseinfo>
<date>25 August 2007</date>
<releaseinfo>Version 1.2</releaseinfo>
<date>28 October 2010</date>
<authorgroup>
<author>
<firstname>Mike</firstname>
@ -24,99 +24,24 @@
</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 (sometimes known as
"poptarts") 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 to notify
the user in an asynchronous manner of events.
</para>
<para>
This specification explicitly does not include other types of
@ -127,13 +52,7 @@
Example use cases include:
</para>
<itemizedlist>
<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>Messages from chat programs</para> </listitem>
<listitem><para>Scheduled alarm</para></listitem>
<listitem><para>Completed file transfer</para></listitem>
<listitem><para>New mail notification</para></listitem>
@ -430,7 +349,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>
@ -439,8 +358,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>
@ -451,8 +370,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>
@ -461,12 +380,21 @@
<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 raw image data structure
of signature (iiibiiay) which describes the width, height, rowstride, has
alpha, bits per sample, channels and image data respectively.
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>.
</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>
@ -734,16 +662,20 @@
</thead>
<tbody valign="top">
<row>
<entry><literal>"urgency"</literal></entry>
<entry>byte</entry>
<entry><literal>"action-icons"</literal></entry>
<entry>BOOLEAN</entry>
<entry>
The urgency level.
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.
</entry>
<entry/>
<entry>&gt;= 1.2</entry>
</row>
<row>
<entry><literal>"category"</literal></entry>
<entry>string</entry>
<entry>STRING</entry>
<entry>
The type of notification this is.
</entry>
@ -751,7 +683,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
@ -762,34 +694,62 @@
<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.1</entry>
<entry>&gt;= 1.2</entry>
</row>
<row>
<entry><literal>"image_path"</literal></entry>
<entry>string</entry>
<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.1</entry>
<entry>&gt;= 1.2</entry>
</row>
<row>
<entry><literal>"image_path"</literal></entry>
<entry>STRING</entry>
<entry>
<emphasis>Deprecated</emphasis>. Use image-path instead.
</entry>
<entry>= 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>
@ -797,7 +757,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>
@ -808,7 +768,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
@ -816,9 +776,19 @@
</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>int</entry>
<entry>INT32</entry>
<entry>
Specifies the X location on the screen that the notification should
point to. The <literal>"y"</literal> hint must also be specified.
@ -827,13 +797,21 @@
</row>
<row>
<entry><literal>"y"</literal></entry>
<entry>int</entry>
<entry>INT32</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>
@ -853,7 +831,7 @@
<title><literal>org.freedesktop.Notifications.GetCapabilities</literal></title>
<funcsynopsis>
<funcprototype>
<funcdef>STRING_ARRAY
<funcdef>as
<function>org.freedesktop.Notifications.GetCapabilities</function>
</funcdef>
<void/>
@ -871,6 +849,14 @@
<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>
@ -924,6 +910,18 @@
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>
@ -956,8 +954,8 @@
<paramdef>STRING <parameter>app_icon</parameter></paramdef>
<paramdef>STRING <parameter>summary</parameter></paramdef>
<paramdef>STRING <parameter>body</parameter></paramdef>
<paramdef>ARRAY <parameter>actions</parameter></paramdef>
<paramdef>DICT <parameter>hints</parameter></paramdef>
<paramdef>as <parameter>actions</parameter></paramdef>
<paramdef>a{sv} <parameter>hints</parameter></paramdef>
<paramdef>INT32 <parameter>expire_timeout</parameter></paramdef>
</funcprototype>
</funcsynopsis>
@ -1015,7 +1013,7 @@
</row>
<row>
<entry><parameter>actions</parameter></entry>
<entry>ARRAY</entry>
<entry>as</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
@ -1025,7 +1023,7 @@
</row>
<row>
<entry><parameter>hints</parameter></entry>
<entry>DICT</entry>
<entry>a{sv}</entry>
<entry>
Optional hints that can be passed to the server from the client
program. Although clients and servers should never assume each other
@ -1274,6 +1272,65 @@
</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 Normal file
View File

@ -0,0 +1,138 @@
<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 users 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>

View File

@ -1,83 +0,0 @@
## 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

View File

@ -4,6 +4,10 @@
<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>
@ -11,4 +15,16 @@
<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>

View File

@ -4,21 +4,22 @@ 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
@ -27,7 +28,10 @@ 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
@ -43,6 +47,7 @@ notify_init
notify_uninit
notify_is_initted
notify_get_app_name
notify_set_app_name
notify_get_server_caps
notify_get_server_info
</SECTION>

View File

@ -0,0 +1,10 @@
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,
)

View File

@ -1,14 +0,0 @@
<?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>

View File

@ -1,327 +0,0 @@
<!-- ##### 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:

View File

@ -1,78 +0,0 @@
<!-- ##### 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:

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">

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">

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">

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">

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>

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
View File

@ -1,184 +0,0 @@
# 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

View File

@ -5,19 +5,24 @@
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>Christian Hammond</foaf:name>
<foaf:mbox rdf:resource="mailto:chipx86@chipx86.com" />
<gnome:userid>chipx86</gnome:userid>
<foaf:name>Marco Trevisan</foaf:name>
<foaf:mbox rdf:resource="mailto:mail@3v1n0.net" />
<gnome:userid>marcotrevi</gnome:userid>
</foaf:Person>
</maintainer>
<maintainer>
<foaf:Person>
<foaf:name>William Jon McCann</foaf:name>
<foaf:mbox rdf:resource="mailto:william.jon.mccann@gmail.com" />
<gnome:userid>mccann</gnome:userid>
<foaf:name>Logan Rathbone</foaf:name>
<foaf:mbox rdf:resource="mailto:poprocks@gmail.com" />
<gnome:userid>larathbone</gnome:userid>
</foaf:Person>
</maintainer>
</Project>

View File

@ -1,12 +0,0 @@
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}

View File

@ -1,92 +0,0 @@
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

View File

@ -22,19 +22,17 @@
#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
DBusGConnection * _notify_get_dbus_g_conn (void);
DBusGProxy * _notify_get_g_proxy (void);
GDBusProxy * _notify_get_proxy (GError **error);
void _notify_cache_add_notification (NotifyNotification *n);
void _notify_cache_remove_notification (NotifyNotification *n);
@ -42,6 +40,14 @@ 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 Normal file
View File

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

86
libnotify/meson.build Normal file
View File

@ -0,0 +1,86 @@
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)

File diff suppressed because it is too large Load Diff

View File

@ -25,11 +25,23 @@
#include <glib.h>
#include <glib-object.h>
#include <gtk/gtk.h>
#include <gdk-pixbuf/gdk-pixbuf.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 ())
@ -43,9 +55,16 @@ 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;
};
@ -57,8 +76,14 @@ struct _NotifyNotificationClass
void (*closed) (NotifyNotification *notification);
};
/*
* Notification urgency levels.
/**
* 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.
*/
typedef enum
{
@ -68,40 +93,61 @@ 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,
GtkWidget *attach);
NotifyNotification *notify_notification_new_with_status_icon (const char *summary,
const char *body,
const char *icon,
GtkStatusIcon *status_icon);
const char *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);
@ -114,10 +160,12 @@ 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,
@ -142,6 +190,14 @@ 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);
@ -152,6 +208,8 @@ 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);

View File

@ -2,21 +2,20 @@
*
* Copyright (C) 2010 Red Hat, Inc.
*
* 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 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 distributed in the hope that it will be useful,
* 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
* General Public License for more details.
* Lesser General Public License for more details.
*
* You should have received a copy of the GNU General Public
* License along with this program; if not, write to the
* 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.
*
* Boston, MA 02111-1307, USA.
*/
#ifndef __NOTIFY_VERSION_H__

View File

@ -3,6 +3,7 @@
* 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
@ -27,17 +28,29 @@
#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 DBusGProxy *_proxy = NULL;
static DBusGConnection *_dbus_gconn = NULL;
static char *_snap_name = NULL;
static char *_snap_app = NULL;
static char *_flatpak_app = NULL;
static GDBusProxy *_proxy = 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,
@ -51,11 +64,72 @@ _notify_check_spec_version (int major,
}
static gboolean
_notify_update_spec_version (void)
_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)
{
char *spec_version;
if (!notify_get_server_info (NULL, NULL, NULL, &spec_version)) {
if (!_notify_get_server_info (NULL, NULL, NULL, &spec_version, error)) {
return FALSE;
}
@ -69,32 +143,290 @@ _notify_update_spec_version (void)
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: The name of the application initializing libnotify.
* @app_name: (nullable): 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;
_app_name = g_strdup (app_name);
if (app_name == NULL) {
GApplication *application;
g_type_init ();
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;
}
_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:
*
@ -141,8 +473,18 @@ 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;
}
@ -159,136 +501,165 @@ notify_is_initted (void)
return _initted;
}
DBusGConnection *
_notify_get_dbus_g_conn (void)
GDBusProxy *
_get_portal_proxy (GError **error)
{
return _dbus_gconn;
}
GError *local_error = NULL;
GDBusProxy *proxy;
GVariant *res;
static void
on_proxy_destroy (DBusGProxy *proxy,
gpointer data)
{
_proxy = NULL;
}
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);
DBusGProxy *
_notify_get_g_proxy (void)
{
GError *error;
DBusGConnection *bus;
if (proxy == NULL) {
g_debug ("Failed to get portal proxy: %s", local_error->message);
g_clear_error (&local_error);
if (_proxy != NULL)
return _proxy;
/* 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;
}
_proxy = dbus_g_proxy_new_for_name (bus,
NOTIFY_DBUS_NAME,
NOTIFY_DBUS_CORE_OBJECT,
NOTIFY_DBUS_CORE_INTERFACE);
dbus_g_connection_unref (bus);
res = g_dbus_proxy_get_cached_property (proxy, "version");
if (!res) {
g_object_unref (proxy);
return NULL;
}
g_signal_connect (_proxy,
"destroy",
G_CALLBACK (on_proxy_destroy),
NULL);
_portal_version = g_variant_get_uint32 (res);
g_assert (_portal_version > 0);
dbus_g_object_register_marshaller (notify_marshal_VOID__UINT_UINT,
G_TYPE_NONE,
G_TYPE_UINT,
G_TYPE_UINT,
G_TYPE_INVALID);
g_warning ("Running in confined mode, using Portal notifications. "
"Some features and hints won't be supported");
dbus_g_object_register_marshaller (notify_marshal_VOID__UINT_STRING,
G_TYPE_NONE,
G_TYPE_UINT,
G_TYPE_STRING,
G_TYPE_INVALID);
g_variant_unref (res);
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);
return proxy;
}
if (!_notify_update_spec_version ()) {
/*
* _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)
{
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) {
return NULL;
}
if (!_notify_update_spec_version (error)) {
g_object_unref (_proxy);
_proxy = NULL;
return NULL;
}
g_object_add_weak_pointer (G_OBJECT (_proxy), (gpointer *) &_proxy);
return _proxy;
}
/**
* notify_get_server_caps:
*
* Queries the server for its capabilities and returns them in a #GList.
* Synchronously queries the server for its capabilities and returns them in a #GList.
*
* Returns: A #GList of server capability strings.
* 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().
*/
GList *
notify_get_server_caps (void)
{
GError *error;
char **caps;
char **cap;
GList *result;
DBusGProxy *proxy;
GDBusProxy *proxy;
GVariant *result;
char **cap, **caps;
GList *list = NULL;
caps = NULL;
result = NULL;
proxy = _notify_get_g_proxy ();
proxy = _notify_get_proxy (NULL);
if (proxy == NULL) {
g_warning ("Failed to connect to proxy");
return 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);
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) {
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++) {
result = g_list_append (result, g_strdup (*cap));
list = g_list_prepend (list, *cap);
}
g_strfreev (caps);
g_free (caps);
g_variant_unref (result);
return result;
return g_list_reverse (list);
}
/**
* notify_get_server_info:
* @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.
* @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
*
* Queries the server for its information, specifically, the name, vendor,
* Synchronously 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 failure.
* Returns: %TRUE if successful, and the variables passed will be set, %FALSE
* on error. The returned strings must be freed with g_free
*/
gboolean
notify_get_server_info (char **ret_name,
@ -296,57 +667,7 @@ notify_get_server_info (char **ret_name,
char **ret_version,
char **ret_spec_version)
{
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;
return _notify_get_server_info (ret_name, ret_vendor, ret_version, ret_spec_version, NULL);
}
void

View File

@ -23,7 +23,6 @@
#define _LIBNOTIFY_NOTIFY_H_
#include <glib.h>
#include <time.h>
#include <libnotify/notification.h>
#include <libnotify/notify-enum-types.h>
@ -31,55 +30,15 @@
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);
/**
* 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);
const char *notify_get_app_name (void);
void notify_set_app_name (const char *app_name);
/**
* 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,

View File

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

85
meson.build Normal file
View File

@ -0,0 +1,85 @@
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 Normal file
View File

@ -0,0 +1,20 @@
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)')

View File

@ -1,76 +0,0 @@
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 Normal file
View File

@ -0,0 +1,28 @@
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 Normal file
View File

@ -0,0 +1,133 @@
/* -*- 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;
}

View File

@ -34,7 +34,6 @@ 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
@ -48,7 +47,6 @@ 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
@ -61,7 +59,6 @@ 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);

View File

@ -27,13 +27,6 @@
#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
@ -54,17 +47,13 @@ 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);
dbus_connection_setup_with_g_main (conn, NULL);
n = notify_notification_new ("Matt is online", "", NULL, NULL);
n = notify_notification_new ("Matt is online", "", NULL);
notify_notification_set_timeout (n, NOTIFY_EXPIRES_DEFAULT);
notify_notification_add_action (n,
"default",

View File

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

55
tests/test-gir.py Executable file
View File

@ -0,0 +1,55 @@
#!/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()

View File

@ -31,14 +31,7 @@
#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;
@ -48,8 +41,7 @@ main (int argc, char *argv[])
{
char *file;
char *uri;
GdkPixbuf *icon;
GtkWidget *helper;
GdkPixbuf *pixbuf;
gtk_init (&argc, &argv);
@ -59,8 +51,7 @@ main (int argc, char *argv[])
/* Stock icon */
n = notify_notification_new ("Icon Test",
"Testing stock icon",
"appointment-new",
NULL);
"appointment-new");
if (!notify_notification_show (n, NULL)) {
fprintf (stderr, "failed to send notification\n");
@ -80,8 +71,7 @@ main (int argc, char *argv[])
/* URIs */
n = notify_notification_new ("Alert!",
"Testing URI icons",
uri,
NULL);
uri);
if (!notify_notification_show (n, NULL)) {
fprintf (stderr, "failed to send notification\n");
@ -93,30 +83,24 @@ 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;
}
/*
* 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));
notify_notification_set_image_from_pixbuf (n, pixbuf);
g_object_unref (pixbuf);
if (!notify_notification_show (n, NULL)) {
fprintf (stderr, "failed to send notification\n");
return 1;
}
g_object_unref (G_OBJECT (n));
return 0;
}

View File

@ -34,7 +34,6 @@ 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

View File

@ -26,13 +26,6 @@
#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
@ -82,21 +75,17 @@ 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.",
NULL,
NULL);
"drive-harddisk-symbolic");
notify_notification_set_hint (n, "transient", g_variant_new_boolean (TRUE));
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 Normal file
View File

@ -0,0 +1,94 @@
/* -*- 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 Normal file
View File

@ -0,0 +1,112 @@
/* -*- 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;
}

View File

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

View File

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

149
tests/test-resident.c Normal file
View File

@ -0,0 +1,149 @@
/* -*- 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;
}

View File

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

View File

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

52
tests/test-transient.c Normal file
View File

@ -0,0 +1,52 @@
/* -*- 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;
}

View File

@ -32,7 +32,6 @@ 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)) {
@ -45,7 +44,6 @@ 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)) {
@ -57,9 +55,7 @@ main (int argc, char *argv[])
n = notify_notification_new ("Critical Urgency",
"This message will self-destruct in 10 "
"seconds.",
NULL,
"This message will self-destruct in 10 seconds.",
NULL);
notify_notification_set_urgency (n, NOTIFY_URGENCY_CRITICAL);
notify_notification_set_timeout (n, 10000); // 10 seconds

View File

@ -24,11 +24,6 @@
#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
@ -44,19 +39,14 @@ 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);

View File

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

View File

@ -33,7 +33,6 @@ 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);

View File

@ -1,16 +0,0 @@
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 Normal file
View File

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

View File

@ -21,16 +21,19 @@
#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,
@ -98,6 +101,26 @@ 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,
@ -119,18 +142,91 @@ 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;
static gboolean hint_error = FALSE, show_error = FALSE;
static gboolean transient = FALSE;
static gboolean wait = FALSE;
static glong expire_timeout = NOTIFY_EXPIRES_DEFAULT;
GOptionContext *opt_ctx;
NotifyNotification *notify;
@ -146,16 +242,34 @@ main (int argc, char *argv[])
N_
("Specifies the timeout in milliseconds at which to expire the "
"notification."), N_("TIME")},
{"icon", 'i', 0, G_OPTION_ARG_FILENAME, &icons,
{"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,
N_("Specifies an icon filename or stock icon to display."),
N_("ICON[,ICON...]")},
N_("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 int, double, string and byte."),
("Specifies basic extra data to pass. Valid types are boolean, int, double, string, byte and variant."),
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},
@ -167,9 +281,10 @@ main (int argc, char *argv[])
body = NULL;
g_type_init ();
setlocale (LC_ALL, "");
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"));
@ -206,26 +321,43 @@ 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 = notify_notification_new (summary,
body,
icon_str,
NULL);
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_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);
@ -237,7 +369,7 @@ main (int argc, char *argv[])
char **tokens = NULL;
while ((hint = hints[i++])) {
tokens = g_strsplit (hint, ":", -1);
tokens = g_strsplit (hint, ":", 3);
l = g_strv_length (tokens);
if (l != 3) {
@ -254,7 +386,7 @@ main (int argc, char *argv[])
if (!retval) {
fprintf (stderr, "%s\n", error->message);
g_error_free (error);
g_clear_error (&error);
hint_error = TRUE;
}
}
@ -265,12 +397,90 @@ main (int argc, char *argv[])
}
}
if (!hint_error)
notify_notification_show (notify, NULL);
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;
}
g_object_unref (G_OBJECT (notify));
notify_uninit ();
exit (hint_error);
if (hint_error || show_error)
exit (1);
return 0;
}