Use - instead of _ in hint names consistently

This commit is contained in:
William Jon McCann 2011-01-17 16:57:31 -05:00
parent a967c61e5b
commit b20752a2e5
2 changed files with 30 additions and 12 deletions

View File

@ -349,7 +349,7 @@
</para> </para>
<para> <para>
The icon is defined by the "app_icon" parameter. The icon is defined by the "app_icon" parameter.
The image can be defined by the "image_path", the "image_data" hint or the The image can be defined by the "image-path", the "image-data" hint or the
deprecated "icon_data" hint. deprecated "icon_data" hint.
</para> </para>
<sect2> <sect2>
@ -358,8 +358,8 @@
An implementation which only displays one image or icon must choose which one An implementation which only displays one image or icon must choose which one
to display using the following order: to display using the following order:
<orderedlist> <orderedlist>
<listitem><para>"image_data"</para></listitem> <listitem><para>"image-data"</para></listitem>
<listitem><para>"image_path"</para></listitem> <listitem><para>"image-path"</para></listitem>
<listitem><para>app_icon parameter</para></listitem> <listitem><para>app_icon parameter</para></listitem>
<listitem><para>for compatibility reason, "icon_data"</para></listitem> <listitem><para>for compatibility reason, "icon_data"</para></listitem>
</orderedlist> </orderedlist>
@ -370,8 +370,8 @@
icon from the "app_icon" parameter and choose which image to display using icon from the "app_icon" parameter and choose which image to display using
the following order: the following order:
<orderedlist> <orderedlist>
<listitem><para>"image_data"</para></listitem> <listitem><para>"image-data"</para></listitem>
<listitem><para>"image_path"</para></listitem> <listitem><para>"image-path"</para></listitem>
<listitem><para>for compatibility reason, "icon_data"</para></listitem> <listitem><para>for compatibility reason, "icon_data"</para></listitem>
</orderedlist> </orderedlist>
</para> </para>
@ -380,12 +380,12 @@
<sect2 id="icons-and-images-formats" xreflabel="Icons and Images Formats"> <sect2 id="icons-and-images-formats" xreflabel="Icons and Images Formats">
<title>Formats</title> <title>Formats</title>
<para> <para>
The "image_data" and "icon_data" hints should be a raw image data structure The "image-data" and "icon_data" hints should be a raw image data structure
of signature (iiibiiay) which describes the width, height, rowstride, has of signature (iiibiiay) which describes the width, height, rowstride, has
alpha, bits per sample, channels and image data respectively. alpha, bits per sample, channels and image data respectively.
</para> </para>
<para> <para>
The "app_icon" parameter and "image_path" hint should be either an URI The "app_icon" parameter and "image-path" hint should be either an URI
(file:// is the only URI schema supported right now) or a name in a (file:// is the only URI schema supported right now) or a name in a
freedesktop.org-compliant icon theme (not a GTK+ stock ID). freedesktop.org-compliant icon theme (not a GTK+ stock ID).
</para> </para>
@ -685,14 +685,30 @@
<entry/> <entry/>
</row> </row>
<row> <row>
<entry><literal>"image_data"</literal></entry> <entry><literal>"image-data"</literal></entry>
<entry>(iiibiiay)</entry> <entry>(iiibiiay)</entry>
<entry> <entry>
This is a raw data image format which describes the width, height, This is a raw data image format which describes the width, height,
rowstride, has alpha, bits per sample, channels and image data rowstride, has alpha, bits per sample, channels and image data
respectively. respectively.
</entry> </entry>
<entry>&gt;= 1.1</entry> <entry>&gt;= 1.2</entry>
</row>
<row>
<entry><literal>"image_data"</literal></entry>
<entry>(iiibiiay)</entry>
<entry>
<emphasis>Deprecated</emphasis>. Use image-data instead.
</entry>
<entry>= 1.1</entry>
</row>
<row>
<entry><literal>"image-path"</literal></entry>
<entry>string</entry>
<entry>
Alternative way to define the notification image. See <xref linkend="icons-and-images"/>.
</entry>
<entry>&gt;= 1.2</entry>
</row> </row>
<row> <row>
<entry><literal>"image_path"</literal></entry> <entry><literal>"image_path"</literal></entry>
@ -700,13 +716,13 @@
<entry> <entry>
Alternative way to define the notification image. See <xref linkend="icons-and-images"/>. Alternative way to define the notification image. See <xref linkend="icons-and-images"/>.
</entry> </entry>
<entry>&gt;= 1.1</entry> <entry>= 1.1</entry>
</row> </row>
<row> <row>
<entry><literal>"icon_data"</literal></entry> <entry><literal>"icon_data"</literal></entry>
<entry>(iiibiiay)</entry> <entry>(iiibiiay)</entry>
<entry> <entry>
<emphasis>Deprecated</emphasis>. Use image_data instead. <emphasis>Deprecated</emphasis>. Use image-data instead.
</entry> </entry>
<entry>&lt; 1.1</entry> <entry>&lt; 1.1</entry>
</row> </row>

View File

@ -682,7 +682,9 @@ notify_notification_set_image_from_pixbuf (NotifyNotification *notification,
g_return_if_fail (pixbuf == NULL || GDK_IS_PIXBUF (pixbuf)); g_return_if_fail (pixbuf == NULL || GDK_IS_PIXBUF (pixbuf));
if (_notify_check_spec_version(1, 1)) { if (_notify_check_spec_version(1, 2)) {
hint_name = "image-data";
} else if (_notify_check_spec_version(1, 1)) {
hint_name = "image_data"; hint_name = "image_data";
} else { } else {
hint_name = "icon_data"; hint_name = "icon_data";