[glib] g_date_time_format: add standards notes to the doc



commit 9860c83ad63ec664a25cf1719ceaeeed70b059d9
Author: Ryan Lortie <desrt desrt ca>
Date:   Fri Sep 2 21:12:16 2011 -0400

    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 files changed, 9 insertions(+), 4 deletions(-)
---
diff --git a/glib/gdatetime.c b/glib/gdatetime.c
index 4a20310..a89cf39 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:
  *



[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]