Commit a43d02f0 authored by Michael Albinus's avatar Michael Albinus
Browse files

* os.texi (Notifications): Update descriptions of

notifications-notify, notifications-close-notification and
notifications-get-capabilities according to latest code changes.
Add notifications-get-server-information.
parent 6b064c16
2012-11-08 Michael Albinus <michael.albinus@gmx.de>
* os.texi (Notifications): Update descriptions of
notifications-notify, notifications-close-notification and
notifications-get-capabilities according to latest code changes.
Add notifications-get-server-information.
2012-11-03 Chong Yidong <cyd@gnu.org>
* objects.texi (General Escape Syntax): Clarify the explanation of
......
......@@ -2276,13 +2276,19 @@ These arguments should consist of alternating keyword and value pairs.
The supported keywords and values are as follows:
@table @code
@item :bus @var{bus}
The D-Bus bus. This argument is needed only if a bus other than
@code{:session} shall be used.
@item :title @var{title}
The notification title.
@item :body @var{text}
The notification body text. Depending on the implementation of the
notification server, the text could contain HTML markups, like
@samp{"<b>bold text</b>"}, hyperlinks, or images.
@samp{"<b>bold text</b>"}, hyperlinks, or images. Special HTML
characters must be encoded, as @samp{"Contact
&lt;postmaster@@localhost&gt;!"}.
@item :app-name @var{name}
The name of the application sending the notification. The default is
......@@ -2317,7 +2323,10 @@ When this keyword is given, the @var{title} string of the actions is
interpreted as icon name.
@item :category @var{category}
The type of notification this is, a string.
The type of notification this is, a string. See the
@uref{http://developer.gnome.org/notification-spec/#categories,
Desktop Notifications Specification} for a list of standard
categories.
@item :desktop-entry @var{filename}
This specifies the name of the desktop filename representing the
......@@ -2420,13 +2429,17 @@ A message window opens on the desktop. Press "I agree"
@end example
@end defun
@defun notifications-close-notification id
@defun notifications-close-notification id &optional bus
This function closes a notification with identifier @var{id}.
@var{bus} can be a string denoting a D-Bus connection, the default is
@code{:session}.
@end defun
@defun notifications-get-capabilities
Returns the capabilities of the notification server, a list of strings.
The following capabilities can be expected:
@defun notifications-get-capabilities &optional bus
Returns the capabilities of the notification server, a list of
symbols. @var{bus} can be a string denoting a D-Bus connection, the
default is @code{:session}. The following capabilities can be
expected:
@table @code
@item :actions
......@@ -2463,6 +2476,30 @@ Further vendor-specific caps start with @code{:x-vendor}, like
@code{:x-gnome-foo-cap}.
@end defun
@defun notifications-get-server-information &optional bus
Return information on the notification server, a list of strings.
@var{bus} can be a string denoting a D-Bus connection, the default is
@code{:session}. The returned list is @code{(@var{name} @var{vendor}
@var{version} @var{spec-version})}.
@table @var
@item name
The product name of the server.
@item vendor
The vendor name. For example, @samp{"KDE"}, @samp{"GNOME"}.
@item version
The server's version number.
@item spec-version
The specification version the server is compliant with.
@end table
If @var{SPEC_VERSION} is @code{nil}, the server supports a
specification prior to @samp{"1.0"}.
@end defun
@node Dynamic Libraries
@section Dynamically Loaded Libraries
......
Markdown is supported
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment