From 9860c83ad63ec664a25cf1719ceaeeed70b059d9 Mon Sep 17 00:00:00 2001 From: Ryan Lortie Date: Fri, 2 Sep 2011 21:12:16 -0400 Subject: [PATCH] g_date_time_format: add standards notes to the doc Explicitly mention C99's strftime() in the documentation for g_date_time_format() as the one that we aim for compatibility with. Specifically list the formats we do not support as well as the extra ones that we borrow from glibc. --- glib/gdatetime.c | 13 +++++++++---- 1 file changed, 9 insertions(+), 4 deletions(-) diff --git a/glib/gdatetime.c b/glib/gdatetime.c index 4a2031076..a89cf395c 100644 --- a/glib/gdatetime.c +++ b/glib/gdatetime.c @@ -2123,10 +2123,15 @@ get_numeric_format (gchar *fmt, * Creates a newly allocated string representing the requested @format. * * The format strings understood by this function are a subset of the - * strftime() format language. In contrast to strftime(), this function - * always produces a UTF-8 string, regardless of the current locale. - * Note that the rendering of many formats is locale-dependent and may - * not match the strftime() output exactly. + * strftime() format language as specified by C99. The %%D, %%U and %%W + * conversions are not supported, nor is the 'E' modifier. The GNU + * extensions %%k, %%l, %%s and %%P are supported, however, as are the + * '0', '_' and '-' modifiers. + * + * In contrast to strftime(), this function always produces a UTF-8 + * string, regardless of the current locale. Note that the rendering of + * many formats is locale-dependent and may not match the strftime() + * output exactly. * * The following format specifiers are supported: *