diff options
| author | Tor Lillqvist <tml@novell.com> | 2006-07-20 09:52:22 +0000 |
|---|---|---|
| committer | Tor Lillqvist <tml@src.gnome.org> | 2006-07-20 09:52:22 +0000 |
| commit | 9a0f54fe92112003dbb2687329192968ed862913 (patch) | |
| tree | f016361be98c6ee899dfd691dd3979a3c52eeef7 | |
| parent | b24074453978cce25f80faaee032d23a7e166fec (diff) | |
Improve doc for g_date_strftime(). (#346197)
2006-07-20 Tor Lillqvist <tml@novell.com>
* glib/tmpl/date.sgml: Improve doc for
g_date_strftime(). (#346197)
| -rw-r--r-- | docs/reference/ChangeLog | 5 | ||||
| -rw-r--r-- | docs/reference/glib/tmpl/date.sgml | 17 |
2 files changed, 19 insertions, 3 deletions
diff --git a/docs/reference/ChangeLog b/docs/reference/ChangeLog index bf55e476e..095959aaa 100644 --- a/docs/reference/ChangeLog +++ b/docs/reference/ChangeLog @@ -1,3 +1,8 @@ +2006-07-20 Tor Lillqvist <tml@novell.com> + + * glib/tmpl/date.sgml: Improve doc for + g_date_strftime(). (#346197) + 2006-07-05 Matthias Clasen <mclasen@redhat.com> * glib/tmpl/base64.sgml: Remove bogus reference diff --git a/docs/reference/glib/tmpl/date.sgml b/docs/reference/glib/tmpl/date.sgml index 4abf160de..4ae06be5d 100644 --- a/docs/reference/glib/tmpl/date.sgml +++ b/docs/reference/glib/tmpl/date.sgml @@ -685,9 +685,20 @@ to be a Sunday.) <!-- ##### FUNCTION g_date_strftime ##### --> <para> Generates a printed representation of the date, in a locale-specific -way. Works just like the standard C <function>strftime()</function> -function, but only accepts date-related formats; time-related formats -give undefined results. Date must be valid. +way. Works just like the platform's C library +<function>strftime()</function> function, but only accepts +date-related formats; time-related formats give undefined +results. Date must be valid. Unlike <function>strftime()</function> +(which uses the locale encoding), works on a UTF-8 format string and +stores a UTF-8 result. +</para> + +<para> +This function does not provide any conversion specifiers in addition +to those implemented by the platform's C library. For example, don't +expect that using <function>g_date_strftime()</function> would make +the %F provided by the C99 <function>strftime()</function> work on +Windows where the C library only complies to C89. </para> @s: destination buffer. |