From b8c2fd7e05e18cb45eb83c751df394e0e3174084 Mon Sep 17 00:00:00 2001 From: Ryan Lortie Date: Fri, 2 Sep 2011 20:53:02 -0400 Subject: [PATCH] g_date_time_format: clarify documentation Add some clarification to the documentation for %g, %G, %V and %u formats (which all concern themselves with ISO 8601 week dates). --- glib/gdatetime.c | 20 ++++++++++++-------- 1 file changed, 12 insertions(+), 8 deletions(-) diff --git a/glib/gdatetime.c b/glib/gdatetime.c index d3152d630..76bbd621b 100644 --- a/glib/gdatetime.c +++ b/glib/gdatetime.c @@ -2184,13 +2184,14 @@ get_numeric_format (gchar *fmt, * * %%g: * - * the last two digits of the ISO week-based year as a decimal number - * (00-99). + * the last two digits of the ISO 8601 week-based year as a decimal + * number (00-99). This works well with %%V and %%u. * * * %%G: * - * the ISO week-based year as a decimal number + * the ISO 8601 week-based year as a decimal number. This works well + * with %%V and %%u. * * * %%h: @@ -2283,19 +2284,22 @@ get_numeric_format (gchar *fmt, * * %%u: * - * the day of the week as a decimal, range 1 to 7, Monday being 1 + * 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. * * * %%V: * - * the ISO 8601 week number of the current year as a decimal 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(). + * 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 + * least 4 days in the new year. See g_date_time_get_week_of_year(). + * This works well with %%G and %%u. * * * %%w: * - * 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. * * * %%W: