@section Desktop Notifications
@cindex desktop notifications
-Emacs is able to send notifications on systems which support the
+Emacs is able to send @dfn{notifications} on systems that support the
desktop notification specification of freedesktop.org. In order to
-use this functionality, the package @code{notifications} must be loaded.
+use this functionality, Emacs must have been compiled with D-Bus
+support, and the @code{notifications} library must be loaded.
@defun notifications-notify &rest params
This function sends a notification to the desktop via D-Bus.
@samp{"<b>bold text</b>"}, or hyperlinks.
@item :app-name @var{name}
-The name of the application sending the notification. Default is
+The name of the application sending the notification. The default is
@code{notifications-application-name}.
@item :replaces-id @var{id}
@item :app-icon @var{icon-file}
The file name of the notification icon. If set to @code{nil}, no icon
-is displayed. Default is @code{notifications-application-icon}.
+is displayed. The default is @code{notifications-application-icon}.
@item :actions (@var{key} @var{title} @var{key} @var{title} ...)
A list of actions to be applied. @var{key} and @var{title} are both
the notification never expires. Default value is -1.
@item :urgency @var{urgency}
-The urgency level. It can be @code{low}, @code{normal} or @code{critical}.
+The urgency level. It can be @code{low}, @code{normal}, or @code{critical}.
@item :category @var{category}
The type of notification this is, a string.
calling program, like @samp{"emacs"}.
@item :image-data (@var{width} @var{height} @var{rowstride} @var{has-alpha} @var{bits} @var{channels} @var{data})
-This is a raw data image format which describes the width, height,
-rowstride, has alpha, bits per sample, channels and image data
-respectively.
+This is a raw data image format that describes the width, height,
+rowstride, whether there is an alpha channel, bits per sample,
+channels and image data, respectively.
@item :image-path @var{path}
This is represented either as a URI (@samp{file://} is the only URI
@item :x @var{position}
@itemx :y @var{position}
-Specifies the X respectively Y location on the screen that the
+Specifies the X, Y location on the screen that the
notification should point to. Both arguments must be used together.
@item :on-action @var{function}
This function returns a notification id, an integer, which can be used
to manipulate the notification item with
@code{notifications-close-notification} or the @code{:replaces-id}
-argument of another @code{notifications-notify} call.
-
-Example:
+argument of another @code{notifications-notify} call. For example:
@example
@group
@end defun
@defun notifications-close-notification id
-This function closes a notification with identifier ID.
+This function closes a notification with identifier @var{id}.
@end defun
@node Dynamic Libraries