GIcon: Convert docs to markdown

This commit is contained in:
Matthias Clasen 2014-01-31 23:01:30 -05:00
parent 192ddc0792
commit fee9194ade

View File

@ -193,19 +193,14 @@ g_icon_to_string_tokenized (GIcon *icon, GString *s)
* The encoding of the returned string is proprietary to #GIcon except
* in the following two cases
*
* <itemizedlist>
* <listitem><para>
* If @icon is a #GFileIcon, the returned string is a native path
* (such as <literal>/path/to/my icon.png</literal>) without escaping
* if the #GFile for @icon is a native file. If the file is not
* native, the returned string is the result of g_file_get_uri()
* (such as <literal>sftp://path/to/my&percnt;20icon.png</literal>).
* </para></listitem>
* <listitem><para>
* If @icon is a #GThemedIcon with exactly one name, the encoding is
* - If @icon is a #GFileIcon, the returned string is a native path
* (such as <literal>/path/to/my icon.png</literal>) without escaping
* if the #GFile for @icon is a native file. If the file is not
* native, the returned string is the result of g_file_get_uri()
* (such as <literal>sftp://path/to/my&percnt;20icon.png</literal>).
*
* - If @icon is a #GThemedIcon with exactly one name, the encoding is
* simply the name (such as <literal>network-server</literal>).
* </para></listitem>
* </itemizedlist>
*
* Virtual: to_tokens
* Returns: An allocated NUL-terminated UTF8 string or %NULL if @icon can't