gtk-doc fixups for glib/

This commit is contained in:
Ryan Lortie
2011-09-05 11:30:58 -04:00
parent 118fa5d502
commit 3b25e975b3
9 changed files with 64 additions and 64 deletions

View File

@@ -714,7 +714,7 @@ string and stores a UTF-8 result.
<para> <para>
This function does not provide any conversion specifiers in addition This function does not provide any conversion specifiers in addition
to those implemented by the platform's C library. For example, don't to those implemented by the platform's C library. For example, don't
expect that using g_date_strftime() would make the %F provided by the C99 expect that using g_date_strftime() would make the \%F provided by the C99
strftime() work on Windows where the C library only complies to C89. strftime() work on Windows where the C library only complies to C89.
</para> </para>

View File

@@ -3208,9 +3208,9 @@ g_bookmark_file_has_application (GBookmarkFile *bookmark,
* *
* @name can be any UTF-8 encoded string used to identify an * @name can be any UTF-8 encoded string used to identify an
* application. * application.
* @exec can have one of these two modifiers: "%f", which will * @exec can have one of these two modifiers: "\%f", which will
* be expanded as the local file name retrieved from the bookmark's * be expanded as the local file name retrieved from the bookmark's
* URI; "%u", which will be expanded as the bookmark's URI. * URI; "\%u", which will be expanded as the bookmark's URI.
* The expansion is done automatically when retrieving the stored * The expansion is done automatically when retrieving the stored
* command line using the g_bookmark_file_get_app_info() function. * command line using the g_bookmark_file_get_app_info() function.
* @count is the number of times the application has registered the * @count is the number of times the application has registered the

View File

@@ -2146,9 +2146,9 @@ format_number (GString *str,
* Creates a newly allocated string representing the requested @format. * Creates a newly allocated string representing the requested @format.
* *
* The format strings understood by this function are a subset of the * The format strings understood by this function are a subset of the
* strftime() format language as specified by C99. The %%D, %%U and %%W * strftime() format language as specified by C99. The \%D, \%U and \%W
* conversions are not supported, nor is the 'E' modifier. The GNU * conversions are not supported, nor is the 'E' modifier. The GNU
* extensions %%k, %%l, %%s and %%P are supported, however, as are the * extensions \%k, \%l, \%s and \%P are supported, however, as are the
* '0', '_' and '-' modifiers. * '0', '_' and '-' modifiers.
* *
* In contrast to strftime(), this function always produces a UTF-8 * In contrast to strftime(), this function always produces a UTF-8
@@ -2160,207 +2160,207 @@ format_number (GString *str,
* *
* <variablelist> * <variablelist>
* <varlistentry><term> * <varlistentry><term>
* <literal>%%a</literal>: * <literal>\%a</literal>:
* </term><listitem><simpara> * </term><listitem><simpara>
* the abbreviated weekday name according to the current locale * the abbreviated weekday name according to the current locale
* </simpara></listitem></varlistentry> * </simpara></listitem></varlistentry>
* <varlistentry><term> * <varlistentry><term>
* <literal>%%A</literal>: * <literal>\%A</literal>:
* </term><listitem><simpara> * </term><listitem><simpara>
* the full weekday name according to the current locale * the full weekday name according to the current locale
* </simpara></listitem></varlistentry> * </simpara></listitem></varlistentry>
* <varlistentry><term> * <varlistentry><term>
* <literal>%%b</literal>: * <literal>\%b</literal>:
* </term><listitem><simpara> * </term><listitem><simpara>
* the abbreviated month name according to the current locale * the abbreviated month name according to the current locale
* </simpara></listitem></varlistentry> * </simpara></listitem></varlistentry>
* <varlistentry><term> * <varlistentry><term>
* <literal>%%B</literal>: * <literal>\%B</literal>:
* </term><listitem><simpara> * </term><listitem><simpara>
* the full month name according to the current locale * the full month name according to the current locale
* </simpara></listitem></varlistentry> * </simpara></listitem></varlistentry>
* <varlistentry><term> * <varlistentry><term>
* <literal>%%c</literal>: * <literal>\%c</literal>:
* </term><listitem><simpara> * </term><listitem><simpara>
* the preferred date and time representation for the current locale * the preferred date and time representation for the current locale
* </simpara></listitem></varlistentry> * </simpara></listitem></varlistentry>
* <varlistentry><term> * <varlistentry><term>
* <literal>%%C</literal>: * <literal>\%C</literal>:
* </term><listitem><simpara> * </term><listitem><simpara>
* The century number (year/100) as a 2-digit integer (00-99) * The century number (year/100) as a 2-digit integer (00-99)
* </simpara></listitem></varlistentry> * </simpara></listitem></varlistentry>
* <varlistentry><term> * <varlistentry><term>
* <literal>%%d</literal>: * <literal>\%d</literal>:
* </term><listitem><simpara> * </term><listitem><simpara>
* the day of the month as a decimal number (range 01 to 31) * the day of the month as a decimal number (range 01 to 31)
* </simpara></listitem></varlistentry> * </simpara></listitem></varlistentry>
* <varlistentry><term> * <varlistentry><term>
* <literal>%%e</literal>: * <literal>\%e</literal>:
* </term><listitem><simpara> * </term><listitem><simpara>
* the day of the month as a decimal number (range 1 to 31) * the day of the month as a decimal number (range 1 to 31)
* </simpara></listitem></varlistentry> * </simpara></listitem></varlistentry>
* <varlistentry><term> * <varlistentry><term>
* <literal>%%F</literal>: * <literal>\%F</literal>:
* </term><listitem><simpara> * </term><listitem><simpara>
* equivalent to <literal>%%Y-%%m-%%d</literal> (the ISO 8601 date * equivalent to <literal>\%Y-\%m-\%d</literal> (the ISO 8601 date
* format) * format)
* </simpara></listitem></varlistentry> * </simpara></listitem></varlistentry>
* <varlistentry><term> * <varlistentry><term>
* <literal>%%g</literal>: * <literal>\%g</literal>:
* </term><listitem><simpara> * </term><listitem><simpara>
* the last two digits of the ISO 8601 week-based year as a decimal * the last two digits of the ISO 8601 week-based year as a decimal
* number (00-99). This works well with %%V and %%u. * number (00-99). This works well with \%V and \%u.
* </simpara></listitem></varlistentry> * </simpara></listitem></varlistentry>
* <varlistentry><term> * <varlistentry><term>
* <literal>%%G</literal>: * <literal>\%G</literal>:
* </term><listitem><simpara> * </term><listitem><simpara>
* the ISO 8601 week-based year as a decimal number. This works well * the ISO 8601 week-based year as a decimal number. This works well
* with %%V and %%u. * with \%V and \%u.
* </simpara></listitem></varlistentry> * </simpara></listitem></varlistentry>
* <varlistentry><term> * <varlistentry><term>
* <literal>%%h</literal>: * <literal>\%h</literal>:
* </term><listitem><simpara> * </term><listitem><simpara>
* equivalent to <literal>%%b</literal> * equivalent to <literal>\%b</literal>
* </simpara></listitem></varlistentry> * </simpara></listitem></varlistentry>
* <varlistentry><term> * <varlistentry><term>
* <literal>%%H</literal>: * <literal>\%H</literal>:
* </term><listitem><simpara> * </term><listitem><simpara>
* the hour as a decimal number using a 24-hour clock (range 00 to * the hour as a decimal number using a 24-hour clock (range 00 to
* 23) * 23)
* </simpara></listitem></varlistentry> * </simpara></listitem></varlistentry>
* <varlistentry><term> * <varlistentry><term>
* <literal>%%I</literal>: * <literal>\%I</literal>:
* </term><listitem><simpara> * </term><listitem><simpara>
* the hour as a decimal number using a 12-hour clock (range 01 to * the hour as a decimal number using a 12-hour clock (range 01 to
* 12) * 12)
* </simpara></listitem></varlistentry> * </simpara></listitem></varlistentry>
* <varlistentry><term> * <varlistentry><term>
* <literal>%%j</literal>: * <literal>\%j</literal>:
* </term><listitem><simpara> * </term><listitem><simpara>
* the day of the year as a decimal number (range 001 to 366) * the day of the year as a decimal number (range 001 to 366)
* </simpara></listitem></varlistentry> * </simpara></listitem></varlistentry>
* <varlistentry><term> * <varlistentry><term>
* <literal>%%k</literal>: * <literal>\%k</literal>:
* </term><listitem><simpara> * </term><listitem><simpara>
* the hour (24-hour clock) as a decimal number (range 0 to 23); * the hour (24-hour clock) as a decimal number (range 0 to 23);
* single digits are preceded by a blank * single digits are preceded by a blank
* </simpara></listitem></varlistentry> * </simpara></listitem></varlistentry>
* <varlistentry><term> * <varlistentry><term>
* <literal>%%l</literal>: * <literal>\%l</literal>:
* </term><listitem><simpara> * </term><listitem><simpara>
* the hour (12-hour clock) as a decimal number (range 1 to 12); * the hour (12-hour clock) as a decimal number (range 1 to 12);
* single digits are preceded by a blank * single digits are preceded by a blank
* </simpara></listitem></varlistentry> * </simpara></listitem></varlistentry>
* <varlistentry><term> * <varlistentry><term>
* <literal>%%m</literal>: * <literal>\%m</literal>:
* </term><listitem><simpara> * </term><listitem><simpara>
* the month as a decimal number (range 01 to 12) * the month as a decimal number (range 01 to 12)
* </simpara></listitem></varlistentry> * </simpara></listitem></varlistentry>
* <varlistentry><term> * <varlistentry><term>
* <literal>%%M</literal>: * <literal>\%M</literal>:
* </term><listitem><simpara> * </term><listitem><simpara>
* the minute as a decimal number (range 00 to 59) * the minute as a decimal number (range 00 to 59)
* </simpara></listitem></varlistentry> * </simpara></listitem></varlistentry>
* <varlistentry><term> * <varlistentry><term>
* <literal>%%p</literal>: * <literal>\%p</literal>:
* </term><listitem><simpara> * </term><listitem><simpara>
* either "AM" or "PM" according to the given time value, or the * either "AM" or "PM" according to the given time value, or the
* corresponding strings for the current locale. Noon is treated as * corresponding strings for the current locale. Noon is treated as
* "PM" and midnight as "AM". * "PM" and midnight as "AM".
* </simpara></listitem></varlistentry> * </simpara></listitem></varlistentry>
* <varlistentry><term> * <varlistentry><term>
* <literal>%%P</literal>: * <literal>\%P</literal>:
* </term><listitem><simpara> * </term><listitem><simpara>
* like %%p but lowercase: "am" or "pm" or a corresponding string for * like \%p but lowercase: "am" or "pm" or a corresponding string for
* the current locale * the current locale
* </simpara></listitem></varlistentry> * </simpara></listitem></varlistentry>
* <varlistentry><term> * <varlistentry><term>
* <literal>%%r</literal>: * <literal>\%r</literal>:
* </term><listitem><simpara> * </term><listitem><simpara>
* the time in a.m. or p.m. notation * the time in a.m. or p.m. notation
* </simpara></listitem></varlistentry> * </simpara></listitem></varlistentry>
* <varlistentry><term> * <varlistentry><term>
* <literal>%%R</literal>: * <literal>\%R</literal>:
* </term><listitem><simpara> * </term><listitem><simpara>
* the time in 24-hour notation (<literal>%%H:%%M</literal>) * the time in 24-hour notation (<literal>\%H:\%M</literal>)
* </simpara></listitem></varlistentry> * </simpara></listitem></varlistentry>
* <varlistentry><term> * <varlistentry><term>
* <literal>%%s</literal>: * <literal>\%s</literal>:
* </term><listitem><simpara> * </term><listitem><simpara>
* the number of seconds since the Epoch, that is, since 1970-01-01 * the number of seconds since the Epoch, that is, since 1970-01-01
* 00:00:00 UTC * 00:00:00 UTC
* </simpara></listitem></varlistentry> * </simpara></listitem></varlistentry>
* <varlistentry><term> * <varlistentry><term>
* <literal>%%S</literal>: * <literal>\%S</literal>:
* </term><listitem><simpara> * </term><listitem><simpara>
* the second as a decimal number (range 00 to 60) * the second as a decimal number (range 00 to 60)
* </simpara></listitem></varlistentry> * </simpara></listitem></varlistentry>
* <varlistentry><term> * <varlistentry><term>
* <literal>%%t</literal>: * <literal>\%t</literal>:
* </term><listitem><simpara> * </term><listitem><simpara>
* a tab character * a tab character
* </simpara></listitem></varlistentry> * </simpara></listitem></varlistentry>
* <varlistentry><term> * <varlistentry><term>
* <literal>%%T</literal>: * <literal>\%T</literal>:
* </term><listitem><simpara> * </term><listitem><simpara>
* the time in 24-hour notation with seconds (<literal>%%H:%%M:%%S</literal>) * the time in 24-hour notation with seconds (<literal>\%H:\%M:\%S</literal>)
* </simpara></listitem></varlistentry> * </simpara></listitem></varlistentry>
* <varlistentry><term> * <varlistentry><term>
* <literal>%%u</literal>: * <literal>\%u</literal>:
* </term><listitem><simpara> * </term><listitem><simpara>
* the ISO 8601 standard day of the week as a decimal, range 1 to 7, * the ISO 8601 standard day of the week as a decimal, range 1 to 7,
* Monday being 1. This works well with %%G and %%V. * Monday being 1. This works well with \%G and \%V.
* </simpara></listitem></varlistentry> * </simpara></listitem></varlistentry>
* <varlistentry><term> * <varlistentry><term>
* <literal>%%V</literal>: * <literal>\%V</literal>:
* </term><listitem><simpara> * </term><listitem><simpara>
* the ISO 8601 standard week number of the current year as a decimal * the ISO 8601 standard week number of the current year as a decimal
* number, range 01 to 53, where week 1 is the first week that has at * number, range 01 to 53, where week 1 is the first week that has at
* least 4 days in the new year. See g_date_time_get_week_of_year(). * least 4 days in the new year. See g_date_time_get_week_of_year().
* This works well with %%G and %%u. * This works well with \%G and \%u.
* </simpara></listitem></varlistentry> * </simpara></listitem></varlistentry>
* <varlistentry><term> * <varlistentry><term>
* <literal>%%w</literal>: * <literal>\%w</literal>:
* </term><listitem><simpara> * </term><listitem><simpara>
* the day of the week as a decimal, range 0 to 6, Sunday being 0. * the day of the week as a decimal, range 0 to 6, Sunday being 0.
* This is not the ISO 8601 standard format -- use %%u instead. * This is not the ISO 8601 standard format -- use \%u instead.
* </simpara></listitem></varlistentry> * </simpara></listitem></varlistentry>
* <varlistentry><term> * <varlistentry><term>
* <literal>%%x</literal>: * <literal>\%x</literal>:
* </term><listitem><simpara> * </term><listitem><simpara>
* the preferred date representation for the current locale without * the preferred date representation for the current locale without
* the time * the time
* </simpara></listitem></varlistentry> * </simpara></listitem></varlistentry>
* <varlistentry><term> * <varlistentry><term>
* <literal>%%X</literal>: * <literal>\%X</literal>:
* </term><listitem><simpara> * </term><listitem><simpara>
* the preferred time representation for the current locale without * the preferred time representation for the current locale without
* the date * the date
* </simpara></listitem></varlistentry> * </simpara></listitem></varlistentry>
* <varlistentry><term> * <varlistentry><term>
* <literal>%%y</literal>: * <literal>\%y</literal>:
* </term><listitem><simpara> * </term><listitem><simpara>
* the year as a decimal number without the century * the year as a decimal number without the century
* </simpara></listitem></varlistentry> * </simpara></listitem></varlistentry>
* <varlistentry><term> * <varlistentry><term>
* <literal>%%Y</literal>: * <literal>\%Y</literal>:
* </term><listitem><simpara> * </term><listitem><simpara>
* the year as a decimal number including the century * the year as a decimal number including the century
* </simpara></listitem></varlistentry> * </simpara></listitem></varlistentry>
* <varlistentry><term> * <varlistentry><term>
* <literal>%%z</literal>: * <literal>\%z</literal>:
* </term><listitem><simpara> * </term><listitem><simpara>
* the time-zone as hour offset from UTC * the time-zone as hour offset from UTC
* </simpara></listitem></varlistentry> * </simpara></listitem></varlistentry>
* <varlistentry><term> * <varlistentry><term>
* <literal>%%Z</literal>: * <literal>\%Z</literal>:
* </term><listitem><simpara> * </term><listitem><simpara>
* the time zone or name or abbreviation * the time zone or name or abbreviation
* </simpara></listitem></varlistentry> * </simpara></listitem></varlistentry>
* <varlistentry><term> * <varlistentry><term>
* <literal>%%%</literal>: * <literal>\%\%</literal>:
* </term><listitem><simpara> * </term><listitem><simpara>
* a literal <literal>%%</literal> character * a literal <literal>\%</literal> character
* </simpara></listitem></varlistentry> * </simpara></listitem></varlistentry>
* </variablelist> * </variablelist>
* *

View File

@@ -262,7 +262,7 @@ g_unix_signal_add_full (int priority,
} }
/** /**
* g_unix_signal_add_full: * g_unix_signal_add:
* @signum: Signal number * @signum: Signal number
* @handler: Callback * @handler: Callback
* @user_data: Data for @handler * @user_data: Data for @handler

View File

@@ -40,12 +40,12 @@
/** /**
* G_UNIX_ERROR: * G_UNIX_ERROR:
* *
* Error domain for API in the "g_unix_" namespace. Note that there * Error domain for API in the "g_unix_" namespace. Note that there is
* is no exported enumeration mapping %errno. Instead, all functions * no exported enumeration mapping %errno. Instead, all functions
* ensure that %errno is relevant. The code for all #G_UNIX_ERROR is * ensure that %errno is relevant. The code for all #G_UNIX_ERROR is
* always %0, and the error message is always generated via * always <literal>0</literal>, and the error message is always
* g_strerror(). * generated via g_strerror().
* *
* It is expected that most code will not look at %errno from these * It is expected that most code will not look at %errno from these
* APIs. Important cases where one would want to differentiate between * APIs. Important cases where one would want to differentiate between

View File

@@ -3788,7 +3788,7 @@ g_main_context_wakeup (GMainContext *context)
* @context: a #GMainContext * @context: a #GMainContext
* *
* Determines whether this thread holds the (recursive) * Determines whether this thread holds the (recursive)
* ownership of this #GMaincontext. This is useful to * ownership of this #GMainContext. This is useful to
* know before waiting on another thread that may be * know before waiting on another thread that may be
* blocking to get ownership of @context. * blocking to get ownership of @context.
* *

View File

@@ -801,7 +801,7 @@ g_test_message (const char *format,
* case only. * case only.
* Bug URIs are constructed by appending a bug specific URI * Bug URIs are constructed by appending a bug specific URI
* portion to @uri_pattern, or by replacing the special string * portion to @uri_pattern, or by replacing the special string
* '%s' within @uri_pattern if that is present. * '\%s' within @uri_pattern if that is present.
* *
* Since: 2.16 * Since: 2.16
*/ */

View File

@@ -49,8 +49,8 @@ G_BEGIN_DECLS
* letters, prefixed by the string "U+". Leading zeros are omitted, * letters, prefixed by the string "U+". Leading zeros are omitted,
* unless the code point would have fewer than four hexadecimal digits. * unless the code point would have fewer than four hexadecimal digits.
* For example, "U+0041 LATIN CAPITAL LETTER A". To print a code point * For example, "U+0041 LATIN CAPITAL LETTER A". To print a code point
* in the U+-notation, use the format string "U+%04"G_GINT32_FORMAT"X". * in the U+-notation, use the format string "U+\%04"G_GINT32_FORMAT"X".
* To scan, use the format string "U+%06"G_GINT32_FORMAT"X". * To scan, use the format string "U+\%06"G_GINT32_FORMAT"X".
* *
* |[ * |[
* gunichar c; * gunichar c;

View File

@@ -1297,7 +1297,7 @@ g_unichar_get_script_bsearch (gunichar ch)
* @ch: a Unicode character * @ch: a Unicode character
* *
* Looks up the #GUnicodeScript for a particular character (as defined * Looks up the #GUnicodeScript for a particular character (as defined
* by Unicode Standard Annex #24). No check is made for @ch being a * by Unicode Standard Annex \#24). No check is made for @ch being a
* valid Unicode character; if you pass in invalid character, the * valid Unicode character; if you pass in invalid character, the
* result is undefined. * result is undefined.
* *