- Removed all references to NIL, and explained briefly how each parameter can be made empty.

- Bumped to version 0.6.
This commit is contained in:
Christian Hammond 2005-04-01 17:12:51 +00:00
parent 2d528a5351
commit d8c0864049
2 changed files with 45 additions and 23 deletions

View File

@ -1,3 +1,10 @@
Fri Apr 01 09:11:38 PST 2005 Christian Hammond <chipx86@gnupdate.org>
* notification-spec.xml:
- Removed all references to NIL, and explained briefly how each
parameter can be made empty.
- Bumped to version 0.6.
Fri Oct 01 23:44:40 PDT 2004 Christian Hammond <chipx86@gnupdate.org>
* notification-spec.xml:

View File

@ -29,6 +29,14 @@
</author>
</authorgroup>
<revhistory>
<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>
@ -835,16 +843,16 @@
<funcdef>UINT32
<function>org.freedesktop.Notifications.Notify</function>
</funcdef>
<paramdef>STRING_OR_NIL <parameter>app_name</parameter></paramdef>
<paramdef>BYTE_ARRAY_OR_STRING_OR_NIL <parameter>app_icon</parameter></paramdef>
<paramdef>UINT32_OR_NIL <parameter>replaces_id</parameter></paramdef>
<paramdef>STRING_OR_NIL <parameter>notification_type</parameter></paramdef>
<paramdef>STRING <parameter>app_name</parameter></paramdef>
<paramdef>BYTE_ARRAY_OR_STRING <parameter>app_icon</parameter></paramdef>
<paramdef>UINT32 <parameter>replaces_id</parameter></paramdef>
<paramdef>STRING <parameter>notification_type</parameter></paramdef>
<paramdef>BYTE <parameter>urgency_level</parameter></paramdef>
<paramdef>STRING <parameter>summary</parameter></paramdef>
<paramdef>STRING_OR_NIL <parameter>body</parameter></paramdef>
<paramdef>STRING <parameter>body</parameter></paramdef>
<paramdef>ARRAY <parameter>images</parameter></paramdef>
<paramdef>DICT_OR_NIL <parameter>actions</parameter></paramdef>
<paramdef>DICT_OR_NIL <parameter>hints</parameter></paramdef>
<paramdef>DICT <parameter>actions</parameter></paramdef>
<paramdef>DICT <parameter>hints</parameter></paramdef>
<paramdef>BOOL <parameter>expires</parameter></paramdef>
<paramdef>UINT32 <parameter>expire_timeout</parameter></paramdef>
</funcprototype>
@ -865,36 +873,40 @@
<tbody valign="top">
<row>
<entry><parameter>app_name</parameter></entry>
<entry>STRING or NIL</entry>
<entry>STRING</entry>
<entry>
The optional name of the application sending the notification.
Can be blank.
</entry>
</row>
<row>
<entry><parameter>app_icon</parameter></entry>
<entry>BYTE_ARRAY or STRING or NIL</entry>
<entry>BYTE_ARRAY or STRING</entry>
<entry>
The optional program icon of the calling application. This is in
the same format as an image frame. See <xref linkend="icons"/>.
Can be an empty string, indicating no icon.
</entry>
</row>
<row>
<entry><parameter>replaces_id</parameter></entry>
<entry>UINT32 or NIL</entry>
<entry>UINT32</entry>
<entry>
The optional notification ID that this notification replaces. The
server must atomically (ie with no flicker or other visual cues)
replace the given notification with this one. This allows clients to
effectively modify the notification while it's active.
effectively modify the notification while it's active. A value of
value of 0 means that this notification won't replace any
existing notifications.
</entry>
</row>
<row>
<entry><parameter>notification_type</parameter></entry>
<entry>STRING or NIL</entry>
<entry>STRING</entry>
<entry>
The optional notification type ID, for potential server
categorization and logging purposes. See
<xref linkend="notification-types"/>.
<xref linkend="notification-types"/>. Can be empty.
</entry>
</row>
<row>
@ -909,35 +921,38 @@
</row>
<row>
<entry><parameter>body</parameter></entry>
<entry>STRING or NIL</entry>
<entry>The optional detailed body text.</entry>
<entry>STRING</entry>
<entry>The optional detailed body text. Can be empty.</entry>
</row>
<row>
<entry><parameter>images</parameter></entry>
<entry>ARRAY or NIL</entry>
<entry>ARRAY</entry>
<entry>
The optional array of images. See <xref linkend="icons"/>.
The optional array of images. See <xref linkend="icons"/>. Can
be empty.
</entry>
</row>
<row>
<entry><parameter>actions</parameter></entry>
<entry>DICT or NIL</entry>
<entry>DICT</entry>
<entry>
A dictionary key of actions. Each key is the localized name of the
action, as it should appear to the user, and maps to a UINT32 value
containing a program-specific action code. This code will be reported
back to the program if the action is invoked by the user.
back to the program if the action is invoked by the user. Can be
empty.
</entry>
</row>
<row>
<entry><parameter>hints</parameter></entry>
<entry>DICT or NIL</entry>
<entry>DICT</entry>
<entry>
Optional hints that can be passed to the server from the client
program. Although clients and servers should never assume each other
supports any specific hints, they can be used to pass along
information, such as the process PID or window ID, that the server
may be able to make use of. See <xref linkend="hints"/>.
may be able to make use of. See <xref linkend="hints"/>. Can be
empty.
</entry>
</row>
<row>
@ -968,7 +983,7 @@
</tgroup>
</table>
<para>
If <parameter>replaces_id</parameter> is NIL, the return value is a
If <parameter>replaces_id</parameter> is 0, the return value is a
UINT32 that represent the notification. It is unique, and will not be
reused unless a <constant>MAXINT</constant> number of notifications
have been generated. An acceptable implementation may just use an
@ -976,7 +991,7 @@
zero. Servers must make sure not to return zero as an ID.
</para>
<para>
If <parameter>replaces_id</parameter> is not NIL, the returned value
If <parameter>replaces_id</parameter> is not 0, the returned value
is the same value as <parameter>replaces_id</parameter>.
</para>
</sect3>