diff options
author | A. Walton <awalton@gnome.org> | 2010-01-31 15:27:50 -0500 |
---|---|---|
committer | William Jon McCann <jmccann@redhat.com> | 2010-01-31 15:36:28 -0500 |
commit | 5a08fb1ab7b554b103b3860ab8058a061af7772c (patch) | |
tree | 3b4b387e5e5f9e0cb38050469e2733c377a3dad7 /docs/notification-spec.xml | |
parent | 9bc1f5d98384a063aa09076c30674c22a1830a16 (diff) | |
download | libnotify-5a08fb1ab7b554b103b3860ab8058a061af7772c.tar.gz |
[spec] Deprecate icon_data in favor of image_data and image_path hints
As discussed on the XDG list.
http://lists.freedesktop.org/archives/xdg/2009-June/010524.html
http://lists.freedesktop.org/archives/xdg/2009-June/010568.html
Diffstat (limited to 'docs/notification-spec.xml')
-rw-r--r-- | docs/notification-spec.xml | 39 |
1 files changed, 33 insertions, 6 deletions
diff --git a/docs/notification-spec.xml b/docs/notification-spec.xml index 02e08e2..77eba43 100644 --- a/docs/notification-spec.xml +++ b/docs/notification-spec.xml @@ -278,8 +278,9 @@ </seglistitem> <seglistitem> <seg>Icon Data</seg> - <seg>Instead of overloading the icon field we now have an icon_data - field that is used when icon is blank.</seg> + <seg>Deprecated and should not be used in new + implementations. Use the Image Data hint instead. + </seg> </seglistitem> </segmentedlist> </entry> @@ -452,13 +453,23 @@ <title>Icons</title> <para> A notification can optionally have an icon specified by the Notification - Icon field or by the icon_data hint. + Icon field or by the image_data or image_path hints. </para> <para> - The icon_data field should be a raw image data structure of signature + The image_data field 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. </para> + <para> + The image_path hint should be a string that contains the path to an image + to use, or a FreeDesktop.org icon name. + </para> + <para> + In existing implementations, a third deprecated hint "icon_data" may be + present, and is used similarly to the image_data hint. However, + new implementations should not use this hint, and existing + implementations should migrate to image_data instead. + </para> </sect1> <sect1 id="categories" xreflabel="Categories"> @@ -746,12 +757,28 @@ </entry> </row> <row> - <entry><literal>"icon_data"</literal></entry> + <entry><literal>"image_path"</literal></entry> + <entry>string</entry> + <entry> + This is represented either as a 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). + </entry> + </row> + <row> + <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. We use this value if the icon field is left blank. + respectively. + </entry> + </row> + <row> + <entry><literal>"icon_data"</literal></entry> + <entry>(iiibiiay)</entry> + <entry> + <emphasis>Deprecated</emphasis>. Use image_data instead. </entry> </row> <row> |