diff src/util.h @ 13152:4bb701a8736f

[gaim-migrate @ 15515] gaim_utf8_strftime() will now provide %z itself if your C library doesn't have it. I'm going to use this shortly. committer: Tailor Script <[e-mail]>

--- a/src/util.h	Tue Feb 07 07:17:09 2006 +0000
+++ b/src/util.h	Tue Feb 07 07:25:45 2006 +0000
@@ -216,6 +216,13 @@
  * This is essentially strftime(), but it has a static buffer
  * and handles the UTF-8 conversion for the caller.
  *
+ * This function also provides the GNU %z formatter if the underlying C
+ * library doesn't.  However, the format string parser is very naive, which
+ * means that conversions specifiers to %z cannot be guaranteed.  The GNU
+ * strftime(3) man page describes %z as: 'The time-zone as hour offset from
+ * GMT.  Required to emit RFC822-conformant dates
+ * (using "%a, %d %b %Y %H:%M:%S %z"). (GNU)'
+ *
  * @param format The format string
  * @param tm     The time to format, or @c NULL to use the current local time
  *