Script 'mail_helper' called by obssrc
Hello community,
here is the log from the commit of package libnotify for openSUSE:Factory
checked in at 2023-02-25 19:54:39
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
Comparing /work/SRC/openSUSE:Factory/libnotify (Old)
and /work/SRC/openSUSE:Factory/.libnotify.new.31432 (New)
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
Package is "libnotify"
Sat Feb 25 19:54:39 2023 rev:44 rq:1067450 version:0.8.2
Changes:
--------
--- /work/SRC/openSUSE:Factory/libnotify/libnotify.changes 2022-08-05
19:50:40.417404934 +0200
+++ /work/SRC/openSUSE:Factory/.libnotify.new.31432/libnotify.changes
2023-02-25 19:54:47.727149642 +0100
@@ -1,0 +2,16 @@
+Thu Feb 23 14:32:40 UTC 2023 - Bjørn Lie <bjorn....@gmail.com>
+
+- Update to version 0.8.2:
+ + Set new summary for library.
+ + Docs:
+ - Port to gi-docgen.
+ - Fix URL to Desktop Notification Spec.
+ + meson:
+ - Replace deprecated meson.source_root() calls.
+ - Bump minimum meson version to 0.58.
+ + Introspection docs fixes.
+- Following upstreams port to gi-docgen, drop gtk-doc and add
+ meson, xsltproc and pkgconfig(gi-docgen) BuildRequires. Also pass
+ explicit man=true to meson, ensure we are building manpages.
+
+-------------------------------------------------------------------
Old:
----
libnotify-0.8.1.tar.xz
New:
----
libnotify-0.8.2.tar.xz
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
Other differences:
------------------
++++++ libnotify.spec ++++++
--- /var/tmp/diff_new_pack.Y3YxqA/_old 2023-02-25 19:54:48.195152526 +0100
+++ /var/tmp/diff_new_pack.Y3YxqA/_new 2023-02-25 19:54:48.203152575 +0100
@@ -1,7 +1,7 @@
#
# spec file for package libnotify
#
-# Copyright (c) 2022 SUSE LLC
+# Copyright (c) 2023 SUSE LLC
#
# All modifications and additions to the file contributed by third parties
# remain the property of their copyright owners, unless otherwise agreed
@@ -17,7 +17,7 @@
Name: libnotify
-Version: 0.8.1
+Version: 0.8.2
Release: 0
Summary: Notifications Library
License: LGPL-2.1-or-later
@@ -28,10 +28,11 @@
BuildRequires: docbook5-xsl-stylesheets
BuildRequires: gobject-introspection-devel
-BuildRequires: gtk-doc
-BuildRequires: meson
+BuildRequires: meson >= 0.58
BuildRequires: pkgconfig
+BuildRequires: xsltproc
BuildRequires: pkgconfig(gdk-pixbuf-2.0)
+BuildRequires: pkgconfig(gi-docgen)
BuildRequires: pkgconfig(glib-2.0)
BuildRequires: pkgconfig(gtk+-3.0)
@@ -86,6 +87,7 @@
-Dintrospection=enabled \
-Dgtk_doc=true \
-Ddocbook_docs=disabled \
+ -Dman=true \
%{nil}
%meson_build
@@ -96,7 +98,6 @@
%files -n libnotify4
%license COPYING
-%doc AUTHORS NEWS README.md
%{_libdir}/*.so.*
%files -n typelib-1_0-Notify-0_7
@@ -107,10 +108,11 @@
%{_mandir}/man1/notify-send.1%{?ext_man}
%files devel
+%doc AUTHORS NEWS README.md
+%doc %{_datadir}/doc/libnotify-0/
%{_libdir}/*.so
%{_libdir}/pkgconfig/*.pc
%{_includedir}/*
%{_datadir}/gir-1.0/*.gir
-%{_datadir}/gtk-doc/html/libnotify
%changelog
++++++ libnotify-0.8.1.tar.xz -> libnotify-0.8.2.tar.xz ++++++
diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn'
'--exclude=.svnignore' old/libnotify-0.8.1/.gitlab-ci.yml
new/libnotify-0.8.2/.gitlab-ci.yml
--- old/libnotify-0.8.1/.gitlab-ci.yml 2022-07-17 15:00:39.000000000 +0200
+++ new/libnotify-0.8.2/.gitlab-ci.yml 2023-02-17 22:20:15.000000000 +0100
@@ -3,6 +3,7 @@
stages:
- build
+ - deploy
build:ubuntu:
stage: build
@@ -11,7 +12,6 @@
- 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
@@ -23,15 +23,26 @@
python3-setuptools
xsltproc
docbook-xsl-ns
- - pip3 install meson
+ - pip3 install meson gi-docgen
script:
- meson _build -Ddocbook_docs=enabled
- ninja -C _build install
+ - mv _build/docs/reference/libnotify-0 _reference
artifacts:
expose_as: "Build artifacts"
paths:
- _build/docs/notification-spec.html
- - _build/docs/reference/html
- - _build/docs/reference/html/index.html
+ - _reference
- _build/meson-logs
+pages:
+ stage: deploy
+ script:
+ - mkdir public
+ - mv _reference/* public/
+ artifacts:
+ when: on_success
+ paths:
+ - public
+ # https://github.com/linux-test-project/lcov/issues/58
+ allow_failure: true
diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn'
'--exclude=.svnignore' old/libnotify-0.8.1/NEWS new/libnotify-0.8.2/NEWS
--- old/libnotify-0.8.1/NEWS 2022-07-17 15:00:39.000000000 +0200
+++ new/libnotify-0.8.2/NEWS 2023-02-17 22:20:15.000000000 +0100
@@ -1,3 +1,16 @@
+New in 0.8.2
+============
+
+* Set new summary for library [Maximiliano]
+* docs: port to gi-docgen [Maximiliano]
+* docs: Fix URL to Desktop Notification Spec [Andre]
+* meson: replace deprecated meson.source_root() calls [Kai]
+* meson: bump minimum meson version to 0.58 [centaurii]
+* Introspection docs fixes [Maximiliano, Logan]
+
+Contributors:
+ Maximiliano Sandoval R, Andre Klapper, Kai Smith, centaurii, Logan Rathbone
+
New in 0.8.1
============
diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn'
'--exclude=.svnignore' old/libnotify-0.8.1/README.md
new/libnotify-0.8.2/README.md
--- old/libnotify-0.8.1/README.md 2022-07-17 15:00:39.000000000 +0200
+++ new/libnotify-0.8.2/README.md 2023-02-17 22:20:15.000000000 +0100
@@ -1,5 +1,7 @@
# libnotify
+Send desktop notifications.
+
## Description
libnotify is a library for sending desktop notifications to a notification
@@ -10,6 +12,10 @@
It is also a simple wrapper to send cross-desktop Notifications for sandboxed
applications using the [XDG Portal Notification API][portal].
+### Documentation
+
+You can find the nightly documentation at
https://gnome.pages.gitlab.gnome.org/libnotify/.
+
## Notice
For GLib based applications the [GNotification][gnotif] API should be used
diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn'
'--exclude=.svnignore' old/libnotify-0.8.1/docs/notify-send.xml
new/libnotify-0.8.2/docs/notify-send.xml
--- old/libnotify-0.8.1/docs/notify-send.xml 2022-07-17 15:00:39.000000000
+0200
+++ new/libnotify-0.8.2/docs/notify-send.xml 2023-02-17 22:20:15.000000000
+0100
@@ -133,6 +133,6 @@
<refsection>
<info><title>See also</title></info>
- <para>The Desktop Notification Spec on <link
xlink:href="http://www.galago-project.org/specs/notification/";>http://www.galago-project.org/specs/notification/</link>.</para>
+ <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>
diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn'
'--exclude=.svnignore' old/libnotify-0.8.1/docs/reference/libnotify-docs.sgml
new/libnotify-0.8.2/docs/reference/libnotify-docs.sgml
--- old/libnotify-0.8.1/docs/reference/libnotify-docs.sgml 2022-07-17
15:00:39.000000000 +0200
+++ new/libnotify-0.8.2/docs/reference/libnotify-docs.sgml 1970-01-01
01:00:00.000000000 +0100
@@ -1,30 +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>
- <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>
- <title>Libnotify</title>
- <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>
diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn'
'--exclude=.svnignore'
old/libnotify-0.8.1/docs/reference/libnotify-sections.txt
new/libnotify-0.8.2/docs/reference/libnotify-sections.txt
--- old/libnotify-0.8.1/docs/reference/libnotify-sections.txt 2022-07-17
15:00:39.000000000 +0200
+++ new/libnotify-0.8.2/docs/reference/libnotify-sections.txt 1970-01-01
01:00:00.000000000 +0100
@@ -1,54 +0,0 @@
-<SECTION>
-<FILE>notification</FILE>
-NOTIFY_EXPIRES_DEFAULT
-NOTIFY_EXPIRES_NEVER
-<TITLE>NotifyNotification</TITLE>
-NotifyNotification
-NotifyClosedReason
-NotifyUrgency
-NotifyActionCallback
-NOTIFY_ACTION_CALLBACK
-notify_notification_new
-notify_notification_update
-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
-notify_notification_set_hint_byte_array
-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
-notify_notification_get_type
-NOTIFY_NOTIFICATION_CLASS
-NOTIFY_IS_NOTIFICATION_CLASS
-NOTIFY_NOTIFICATION_GET_CLASS
-</SECTION>
-
-<SECTION>
-<FILE>notify</FILE>
-notify_init
-notify_uninit
-notify_is_initted
-notify_get_app_name
-notify_set_app_name
-notify_get_server_caps
-notify_get_server_info
-</SECTION>
-
diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn'
'--exclude=.svnignore' old/libnotify-0.8.1/docs/reference/libnotify.toml.in
new/libnotify-0.8.2/docs/reference/libnotify.toml.in
--- old/libnotify-0.8.1/docs/reference/libnotify.toml.in 1970-01-01
01:00:00.000000000 +0100
+++ new/libnotify-0.8.2/docs/reference/libnotify.toml.in 2023-02-17
22:20:15.000000000 +0100
@@ -0,0 +1,44 @@
+[library]
+version = "@VERSION@"
+browse_url = "https://gitlab.gnome.org/GNOME/libnotify/";
+repository_url = "https://gitlab.gnome.org/GNOME/libnotify.git";
+website_url = "https://gitlab.gnome.org/GNOME/libnotify/";
+docs_url = "https://gnome.pages.gitlab.gnome.org/libnotify/";
+authors = "Marco Trevisan, Logan Rathbone, Christian Hammond, Mike Hearn, and
John (J5) Palmieri"
+license = "LGPL-2.1-or-later"
+description = "Send desktop notifications"
+dependencies = [ "GObject-2.0", "GLib-1.0", "Gio-2.0" ]
+devhelp = true
+search_index = true
+
+[dependencies."GObject-2.0"]
+name = "GObject"
+description = "The base type system library"
+docs_url = "https://docs.gtk.org/gobject/";
+
+[dependencies."GLib-2.0"]
+name = "GLib"
+description = "The base type system library"
+docs_url = "https://docs.gtk.org/glib/";
+
+[dependencies."Gio-2.0"]
+name = "GIO"
+description = "GObject Interfaces and Objects, Networking, IPC, and I/O"
+docs_url = "https://docs.gtk.org/gio/";
+
+[theme]
+name = "basic"
+show_index_summary = true
+show_class_hierarchy = true
+
+[source-location]
+base_url = "https://gitlab.gnome.org/GNOME/libnotify/-/blob/master";
+
+[extra]
+# The same order will be used when generating the index
+content_files = [
+]
+
+content_images = [
+]
+urlmap_file = "urlmap.js"
diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn'
'--exclude=.svnignore' old/libnotify-0.8.1/docs/reference/libnotify.types
new/libnotify-0.8.2/docs/reference/libnotify.types
--- old/libnotify-0.8.1/docs/reference/libnotify.types 2022-07-17
15:00:39.000000000 +0200
+++ new/libnotify-0.8.2/docs/reference/libnotify.types 1970-01-01
01:00:00.000000000 +0100
@@ -1,3 +0,0 @@
-#include <libnotify/notify.h>
-
-notify_notification_get_type
diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn'
'--exclude=.svnignore' old/libnotify-0.8.1/docs/reference/meson.build
new/libnotify-0.8.2/docs/reference/meson.build
--- old/libnotify-0.8.1/docs/reference/meson.build 2022-07-17
15:00:39.000000000 +0200
+++ new/libnotify-0.8.2/docs/reference/meson.build 2023-02-17
22:20:15.000000000 +0100
@@ -1,10 +1,40 @@
-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' ],
+api_version_major = '0'
+expand_content_md_files = []
+
+toml_data = configuration_data()
+toml_data.set('VERSION', meson.project_version())
+
+libnotify_toml = configure_file(
+ input: 'libnotify.toml.in',
+ output: 'libnotify.toml',
+ configuration: toml_data
+)
+
+dependency('gi-docgen', version: '>= 2021.7',
+ fallback: ['gi-docgen', 'dummy_dep'],
+ native: true,
+ required: get_option('gtk_doc'))
+
+gidocgen = find_program('gi-docgen')
+
+docs_dir = get_option('datadir') / 'doc'
+
+custom_target('libnotify-doc',
+ input: [ libnotify_toml, libnotify_gir[0] ],
+ output: 'libnotify-@0@'.format(api_version_major),
+ command: [
+ gidocgen,
+ 'generate',
+ '--quiet',
+ '--add-include-path=@0@'.format(meson.current_build_dir() /
'../../libnotify'),
+ '--config=@INPUT0@',
+ '--output-dir=@OUTPUT@',
+ '--no-namespace-dir',
+ '--content-dir=@0@'.format(meson.current_source_dir()),
+ '@INPUT1@',
+ ],
+ depend_files: [ expand_content_md_files ],
+ build_by_default: true,
install: true,
+ install_dir: docs_dir,
)
diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn'
'--exclude=.svnignore' old/libnotify-0.8.1/docs/reference/urlmap.js
new/libnotify-0.8.2/docs/reference/urlmap.js
--- old/libnotify-0.8.1/docs/reference/urlmap.js 1970-01-01
01:00:00.000000000 +0100
+++ new/libnotify-0.8.2/docs/reference/urlmap.js 2023-02-17
22:20:15.000000000 +0100
@@ -0,0 +1,7 @@
+// A map between namespaces and base URLs for their online documentation
+baseURLs = [
+ [ 'GLib', 'https://docs.gtk.org/glib/' ],
+ [ 'GObject', 'https://docs.gtk.org/gobject/' ],
+ [ 'Gio', 'https://docs.gtk.org/gio/' ],
+ ["GdkPixbuf", "https://docs.gtk.org/gdk-pixbuf/";],
+]
diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn'
'--exclude=.svnignore' old/libnotify-0.8.1/libnotify/meson.build
new/libnotify-0.8.2/libnotify/meson.build
--- old/libnotify-0.8.1/libnotify/meson.build 2022-07-17 15:00:39.000000000
+0200
+++ new/libnotify-0.8.2/libnotify/meson.build 2023-02-17 22:20:15.000000000
+0100
@@ -72,7 +72,7 @@
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,
+ libnotify_gir = gnome.generate_gir(libnotify_lib,
sources: headers + sources + enum_types,
namespace: 'Notify',
nsversion: MODULE_VERSION,
diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn'
'--exclude=.svnignore' old/libnotify-0.8.1/libnotify/notification.c
new/libnotify-0.8.2/libnotify/notification.c
--- old/libnotify-0.8.1/libnotify/notification.c 2022-07-17
15:00:39.000000000 +0200
+++ new/libnotify-0.8.2/libnotify/notification.c 2023-02-17
22:20:15.000000000 +0100
@@ -28,21 +28,6 @@
#include "notify.h"
#include "internal.h"
-
-/**
- * SECTION:notification
- * @Short_description: A passive pop-up notification.
- * @Title: NotifyNotification
- *
- * #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.
- */
-
-
#if !defined(G_PARAM_STATIC_NAME) && !defined(G_PARAM_STATIC_NICK) && \
!defined(G_PARAM_STATIC_BLURB)
# define G_PARAM_STATIC_NAME 0
@@ -173,6 +158,11 @@
G_TYPE_NONE,
0);
+ /**
+ * NotifyNotification:id:
+ *
+ * The Id of the notification.
+ */
g_object_class_install_property (object_class,
PROP_ID,
g_param_spec_int ("id", "ID",
@@ -186,6 +176,13 @@
|
G_PARAM_STATIC_NICK
|
G_PARAM_STATIC_BLURB));
+ /**
+ * NotifyNotification:app-name:
+ *
+ * The name of the application for the notification.
+ *
+ * Since: 0.7.3
+ */
g_object_class_install_property (object_class,
PROP_APP_NAME,
g_param_spec_string ("app-name",
@@ -197,6 +194,11 @@
|
G_PARAM_STATIC_NICK
|
G_PARAM_STATIC_BLURB));
+ /**
+ * NotifyNotification:summary:
+ *
+ * The summary of the notification.
+ */
g_object_class_install_property (object_class,
PROP_SUMMARY,
g_param_spec_string ("summary",
@@ -209,6 +211,11 @@
|
G_PARAM_STATIC_NICK
|
G_PARAM_STATIC_BLURB));
+ /**
+ * NotifyNotification:body:
+ *
+ * The body of the notification.
+ */
g_object_class_install_property (object_class,
PROP_BODY,
g_param_spec_string ("body",
@@ -221,6 +228,11 @@
|
G_PARAM_STATIC_NICK
|
G_PARAM_STATIC_BLURB));
+ /**
+ * NotifyNotification:icon-name:
+ *
+ * The icon-name of the icon to be displayed on the notification.
+ */
g_object_class_install_property (object_class,
PROP_ICON_NAME,
g_param_spec_string ("icon-name",
@@ -233,6 +245,13 @@
|
G_PARAM_STATIC_NICK
|
G_PARAM_STATIC_BLURB));
+ /**
+ * NotifyNotification:closed-reason:
+ *
+ * The closed reason of the notification.
+ *
+ * See [signal@Notification::closed].
+ */
g_object_class_install_property (object_class,
PROP_CLOSED_REASON,
g_param_spec_int ("closed-reason",
@@ -439,12 +458,13 @@
/**
* notify_notification_new:
- * @summary: The required summary text.
- * @body: (allow-none): The optional body text.
- * @icon: (allow-none): The optional icon theme icon name or filename.
+ * @summary: (not nullable): The required summary text.
+ * @body: (nullable): The optional body text.
+ * @icon: (nullable): The optional icon theme icon name or filename.
+ *
+ * Creates a new #NotifyNotification.
*
- * Creates a new #NotifyNotification. The summary text is required, but
- * all other parameters are optional.
+ * The summary text is required, but all other parameters are optional.
*
* Returns: The new #NotifyNotification.
*/
@@ -598,12 +618,13 @@
* notify_notification_update:
* @notification: The notification to update.
* @summary: The new required summary text.
- * @body: (allow-none): The optional body text.
- * @icon: (allow-none): The optional icon theme icon name or filename.
+ * @body: (nullable): The optional body text.
+ * @icon: (nullable): The optional icon theme icon name or filename.
*
- * Updates the notification text and icon. This won't send the update out
- * and display it on the screen. For that, you will need to call
- * notify_notification_show().
+ * Updates the notification text and icon.
+ *
+ * This won't send the update out and display it on the screen. For that, you
+ * will need to call [met...@notification.show].
*
* Returns: %TRUE, unless an invalid parameter was passed.
*/
@@ -1055,7 +1076,7 @@
* Tells the notification server to display the notification on the screen.
*
* Returns: %TRUE if successful. On error, this will return %FALSE and set
- * @error.
+ * @error.
*/
gboolean
notify_notification_show (NotifyNotification *notification,
@@ -1179,9 +1200,10 @@
* @notification: The notification.
* @timeout: The timeout in milliseconds.
*
- * Sets the timeout of the notification. To set the default time, pass
- * %NOTIFY_EXPIRES_DEFAULT as @timeout. To set the notification to never
- * expire, pass %NOTIFY_EXPIRES_NEVER.
+ * Sets the timeout of the notification.
+ *
+ * To set the default time, pass %NOTIFY_EXPIRES_DEFAULT as @timeout. To set
the
+ * notification to never expire, pass %NOTIFY_EXPIRES_NEVER.
*
* Note that the timeout may be ignored by the server.
*/
@@ -1209,8 +1231,10 @@
* @notification: The notification.
* @category: The category.
*
- * Sets the category of this notification. This can be used by the
- * notification server to filter or display the data in a certain way.
+ * Sets the category of this notification.
+ *
+ * This can be used by the notification server to filter or display the data in
+ * a certain way.
*/
void
notify_notification_set_category (NotifyNotification *notification,
@@ -1236,8 +1260,6 @@
* @urgency: The urgency level.
*
* Sets the urgency level of this notification.
- *
- * See: #NotifyUrgency
*/
void
notify_notification_set_urgency (NotifyNotification *notification,
@@ -1257,8 +1279,8 @@
* @icon: The icon.
*
* Sets the icon in the notification from a #GdkPixbuf.
- * Deprecated: use notify_notification_set_image_from_pixbuf() instead.
*
+ * Deprecated: 0.5. Use [method@Notification.set_image_from_pixbuf] instead.
*/
void
notify_notification_set_icon_from_pixbuf (NotifyNotification *notification,
@@ -1272,8 +1294,9 @@
* @notification: The notification.
* @pixbuf: The image.
*
- * Sets the image in the notification from a #GdkPixbuf.
+ * Sets the image in the notification from a [class@GdkPixbuf.Pixbuf].
*
+ * Since: 0.5
*/
void
notify_notification_set_image_from_pixbuf (NotifyNotification *notification,
@@ -1390,10 +1413,11 @@
* notify_notification_set_hint:
* @notification: a #NotifyNotification
* @key: the hint key
- * @value: (allow-none): the hint value, or %NULL to unset the hint
+ * @value: (nullable): the hint value
+ *
+ * Sets a hint for @key with value @value.
*
- * Sets a hint for @key with value @value. If @value is %NULL,
- * a previously set hint for @key is unset.
+ * If @value is %NULL, a previously set hint for @key is unset.
*
* If @value is floating, it is consumed.
*
@@ -1420,12 +1444,13 @@
/**
* notify_notification_set_app_name:
* @notification: a #NotifyNotification
- * @app_name: the localised application name
+ * @app_name: (nullable): the localised application name
*
- * Sets the application name for the notification. If this function is
- * not called or if @app_name is %NULL, the application name will be
- * set from the value used in notify_init() or overridden with
- * notify_set_app_name().
+ * Sets the application name for the notification.
+ *
+ * If this function is not called or if @app_name is %NULL, the application
name
+ * will be set from the value used in [func@init] or overridden with
+ * [func@set_app_name].
*
* Since: 0.7.3
*/
@@ -1453,7 +1478,7 @@
*
* Sets a hint with a 32-bit integer value.
*
- * Deprecated: 0.6. Use notify_notification_set_hint() instead
+ * Deprecated: 0.6. Use [method@Notification.set_hint] instead
*/
void
notify_notification_set_hint_int32 (NotifyNotification *notification,
@@ -1473,7 +1498,7 @@
*
* Sets a hint with an unsigned 32-bit integer value.
*
- * Deprecated: 0.6. Use notify_notification_set_hint() instead
+ * Deprecated: 0.6. Use [method@Notification.set_hint] instead
*/
void
notify_notification_set_hint_uint32 (NotifyNotification *notification,
@@ -1492,7 +1517,7 @@
*
* Sets a hint with a double value.
*
- * Deprecated: 0.6. Use notify_notification_set_hint() instead
+ * Deprecated: 0.6. Use [method@Notification.set_hint] instead
*/
void
notify_notification_set_hint_double (NotifyNotification *notification,
@@ -1511,7 +1536,7 @@
*
* Sets a hint with a byte value.
*
- * Deprecated: 0.6. Use notify_notification_set_hint() instead
+ * Deprecated: 0.6. Use [method@Notification.set_hint] instead
*/
void
notify_notification_set_hint_byte (NotifyNotification *notification,
@@ -1529,10 +1554,11 @@
* @value: (array length=len): The hint's value.
* @len: The length of the byte array.
*
- * Sets a hint with a byte array value. The length of @value must be passed
- * as @len.
+ * Sets a hint with a byte array value.
+ *
+ * The length of @value must be passed as @len.
*
- * Deprecated: 0.6. Use notify_notification_set_hint() instead
+ * Deprecated: 0.6. Use [method@Notification.set_hint] instead
*/
void
notify_notification_set_hint_byte_array (NotifyNotification *notification,
@@ -1566,7 +1592,7 @@
*
* Sets a hint with a string value.
*
- * Deprecated: 0.6. Use notify_notification_set_hint() instead
+ * Deprecated: 0.6. Use [method@Notification.set_hint] instead
*/
void
notify_notification_set_hint_string (NotifyNotification *notification,
@@ -1638,11 +1664,12 @@
* @callback: The action's callback function.
* @user_data: Optional custom data to pass to @callback.
* @free_func: (type GLib.DestroyNotify): An optional function to free
@user_data when the notification
- * is destroyed.
+ * is destroyed.
*
- * Adds an action to a notification. When the action is invoked, the
- * specified callback function will be called, along with the value passed
- * to @user_data.
+ * Adds an action to a notification.
+ *
+ * When the action is invoked, the specified callback function will be called,
+ * along with the value passed to @user_data.
*/
void
notify_notification_add_action (NotifyNotification *notification,
@@ -1681,12 +1708,14 @@
* notify_notification_get_activation_token:
* @notification: The notification.
*
+ * Gets the activation token of the notification.
+ *
* If an an action is currently being activated, return the activation token.
- * This function is intended to be used in a #NotifyActionCallback to get
+ * This function is intended to be used in a [callback@ActionCallback] to get
* the activation token for the activated action, if the notification daemon
* supports it.
*
- * Return value: (transfer none): The current activation token, or %NULL if
none
+ * Returns: (nullable) (transfer none): The current activation token, or %NULL
if none
*
* Since: 0.7.10
*/
@@ -1762,13 +1791,14 @@
* notify_notification_get_closed_reason:
* @notification: The notification.
*
- * Returns the closed reason code for the notification. This is valid only
- * after the "closed" signal is emitted.
+ * Returns the closed reason code for the notification.
+ *
+ * This is valid only after the [signal@Notification::closed] signal is
emitted.
*
- * Since version 0.8.0 the returned value is of type #NotifyClosedReason.
+ * Since version 0.8.0 the returned value is of type [enum@ClosedReason].
*
* Returns: An integer representing the closed reason code
- * (Since 0.8.0 it's also a #NotifyClosedReason).
+ * (Since 0.8.0 it's also a [enum@ClosedReason]).
*/
gint
notify_notification_get_closed_reason (const NotifyNotification *notification)
diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn'
'--exclude=.svnignore' old/libnotify-0.8.1/libnotify/notification.h
new/libnotify-0.8.2/libnotify/notification.h
--- old/libnotify-0.8.1/libnotify/notification.h 2022-07-17
15:00:39.000000000 +0200
+++ new/libnotify-0.8.2/libnotify/notification.h 2023-02-17
22:20:15.000000000 +0100
@@ -39,8 +39,9 @@
/**
* NOTIFY_EXPIRES_NEVER:
*
- * The notification never expires. It stays open until closed by the calling
API
- * or the user.
+ * The notification never expires.
+ *
+ * It stays open until closed by the calling API or the user.
*/
#define NOTIFY_EXPIRES_NEVER 0
@@ -59,6 +60,13 @@
* NotifyNotification:
*
* A passive pop-up notification.
+ *
+ * #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.
*/
struct _NotifyNotification
{
@@ -100,7 +108,7 @@
* @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().
+ * [method@NotifyNotification.close].
* @NOTIFY_CLOSED_REASON_UNDEFIEND: Closed by undefined/reserved reasons.
*
* The reason for which the notification has been closed.
@@ -132,8 +140,9 @@
* NOTIFY_ACTION_CALLBACK:
* @func: The function to cast.
*
- * A convenience macro for casting a function to a #NotifyActionCallback. This
- * is much like G_CALLBACK().
+ * A convenience macro for casting a function to a [callback@ActionCallback].
+ *
+ * This is much like [func@GObject.CALLBACK].
*/
#define NOTIFY_ACTION_CALLBACK(func) ((NotifyActionCallback)(func))
diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn'
'--exclude=.svnignore' old/libnotify-0.8.1/libnotify/notify-features.h.in
new/libnotify-0.8.2/libnotify/notify-features.h.in
--- old/libnotify-0.8.1/libnotify/notify-features.h.in 2022-07-17
15:00:39.000000000 +0200
+++ new/libnotify-0.8.2/libnotify/notify-features.h.in 2023-02-17
22:20:15.000000000 +0100
@@ -23,12 +23,34 @@
/* compile time version
*/
+
+/**
+ * NOTIFY_VERSION_MAJOR:
+ *
+ * Adwaita major version component (e.g. 1 if the version is 1.2.3).
+ */
#define NOTIFY_VERSION_MAJOR (@LIBNOTIFY_MAJOR_VERSION@)
+/**
+ * NOTIFY_VERSION_MINOR:
+ *
+ * Adwaita minor version component (e.g. 2 if the version is 1.2.3).
+ */
#define NOTIFY_VERSION_MINOR (@LIBNOTIFY_MINOR_VERSION@)
+/**
+ * NOTIFY_VERSION_MICRO:
+ *
+ * Adwaita micro version component (e.g. 3 if the version is 1.2.3).
+ */
#define NOTIFY_VERSION_MICRO (@LIBNOTIFY_MICRO_VERSION@)
-/* check whether a version equal to or greater than
- * major.minor.micro is present.
+/**
+ * NOTIFY_CHECK_VERSION:
+ * @major: required major version
+ * @minor: required minor version
+ * @micro: required micro version
+ *
+ * check whether a version equal to or greater than
+ * `major.minor.micro` is present.
*/
#define NOTIFY_CHECK_VERSION(major,minor,micro) \
(NOTIFY_VERSION_MAJOR > (major) || \
diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn'
'--exclude=.svnignore' old/libnotify-0.8.1/libnotify/notify.c
new/libnotify-0.8.2/libnotify/notify.c
--- old/libnotify-0.8.1/libnotify/notify.c 2022-07-17 15:00:39.000000000
+0200
+++ new/libnotify-0.8.2/libnotify/notify.c 2023-02-17 22:20:15.000000000
+0100
@@ -35,12 +35,6 @@
#include "internal.h"
#include "notify-marshal.h"
-/**
- * SECTION:notify
- * @Short_description: Notification API
- * @Title: notify
- */
-
static gboolean _initted = FALSE;
static char *_app_name = NULL;
static char *_snap_name = NULL;
@@ -432,7 +426,7 @@
*
* Gets the application name registered.
*
- * Returns: The registered application name, passed to notify_init().
+ * Returns: The registered application name, passed to [func@init].
*/
const char *
notify_get_app_name (void)
@@ -443,7 +437,7 @@
/**
* notify_uninit:
*
- * Uninitialized libnotify.
+ * Uninitializes libnotify.
*
* This should be called when the program no longer needs libnotify for
* the rest of its lifecycle, typically just before exitting.
@@ -543,12 +537,12 @@
/*
* _notify_get_proxy:
- * @error: (allow-none): a location to store a #GError, or %NULL
+ * @error: (nullable): 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
+ * Returns: (nullable): the #GDBusProxy for the notification service, or %NULL
on error
*/
GDBusProxy *
_notify_get_proxy (GError **error)
@@ -592,10 +586,12 @@
/**
* notify_get_server_caps:
*
- * Synchronously queries the server for its capabilities and returns them in a
#GList.
+ * Queries the server capabilities.
+ *
+ * Synchronously queries the server for its capabilities and returns them in a
+ * list.
*
- * Returns: (transfer full) (element-type utf8): a #GList of server capability
strings. Free
- * the list elements with g_free() and the list itself with g_list_free().
+ * Returns: (transfer full) (element-type utf8): a list of server capability
strings.
*/
GList *
notify_get_server_caps (void)
@@ -649,17 +645,19 @@
/**
* notify_get_server_info:
- * @ret_name: (out) (allow-none) (transfer full): a location to store the
server name, or %NULL
- * @ret_vendor: (out) (allow-none) (transfer full): a location to store the
server vendor, or %NULL
- * @ret_version: (out) (allow-none) (transfer full): a location to store the
server version, or %NULL
- * @ret_spec_version: (out) (allow-none) (transfer full): a location to store
the version the service is compliant with, or %NULL
- *
- * 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.
+ * @ret_name: (out) (optional) (transfer full): a location to store the server
name, or %NULL
+ * @ret_vendor: (out) (optional) (transfer full): a location to store the
server vendor, or %NULL
+ * @ret_version: (out) (optional) (transfer full): a location to store the
server version, or %NULL
+ * @ret_spec_version: (out) (optional) (transfer full): a location to store
the version the service is compliant with, or %NULL
+ *
+ * Queries the server for information.
+ *
+ * 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 error. The returned strings must be freed with g_free
+ * on error. The returned strings must be freed with g_free
*/
gboolean
notify_get_server_info (char **ret_name,
diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn'
'--exclude=.svnignore' old/libnotify-0.8.1/libnotify.doap
new/libnotify-0.8.2/libnotify.doap
--- old/libnotify-0.8.1/libnotify.doap 2022-07-17 15:00:39.000000000 +0200
+++ new/libnotify-0.8.2/libnotify.doap 2023-02-17 22:20:15.000000000 +0100
@@ -7,7 +7,7 @@
<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>
+ <shortdesc xml:lang="en">Send 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>
diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn'
'--exclude=.svnignore' old/libnotify-0.8.1/meson.build
new/libnotify-0.8.2/meson.build
--- old/libnotify-0.8.1/meson.build 2022-07-17 15:00:39.000000000 +0200
+++ new/libnotify-0.8.2/meson.build 2023-02-17 22:20:15.000000000 +0100
@@ -1,7 +1,7 @@
project('libnotify',
'c',
- version: '0.8.1',
- meson_version: '>= 0.47.0')
+ version: '0.8.2',
+ meson_version: '>= 0.56.0')
gnome = import('gnome')
pkgconfig = import('pkgconfig')
diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn'
'--exclude=.svnignore' old/libnotify-0.8.1/meson_options.txt
new/libnotify-0.8.2/meson_options.txt
--- old/libnotify-0.8.1/meson_options.txt 2022-07-17 15:00:39.000000000
+0200
+++ new/libnotify-0.8.2/meson_options.txt 2023-02-17 22:20:15.000000000
+0100
@@ -13,7 +13,7 @@
option('gtk_doc',
type: 'boolean',
value: true,
- description: 'Enable generating the API reference (depends on GTK-Doc)')
+ description: 'Enable generating the API reference (depends on gi-docgen)')
option('docbook_docs',
type: 'feature',
value: 'auto',
diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn'
'--exclude=.svnignore' old/libnotify-0.8.1/subprojects/gi-docgen.wrap
new/libnotify-0.8.2/subprojects/gi-docgen.wrap
--- old/libnotify-0.8.1/subprojects/gi-docgen.wrap 1970-01-01
01:00:00.000000000 +0100
+++ new/libnotify-0.8.2/subprojects/gi-docgen.wrap 2023-02-17
22:20:15.000000000 +0100
@@ -0,0 +1,6 @@
+[wrap-git]
+directory=gi-docgen
+url=https://gitlab.gnome.org/GNOME/gi-docgen.git
+push-url=ssh://g...@gitlab.gnome.org:GNOME/gi-docgen.git
+revision=main
+depth=1
