* lib/strftime.h: Add comments describing the two added arguments.

diff --git a/ChangeLog b/ChangeLog
index 99ab461..4592840 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,5 +1,7 @@
 2008-08-31  Jim Meyering  <meyering@redhat.com>
 
+       * lib/strftime.h: Add comments describing the two added arguments.
+
        remove duplicate #include directives
        * lib/chdir-long.c [TEST_CHDIR]: Remove duplicate #include <stdio.h>.
        * lib/putenv.c: Remove duplicate #include <stdlib.h>.

diff --git a/lib/strftime.h b/lib/strftime.h
index ae9cc6b..c3c183e 100644 (file)
--- a/lib/strftime.h
+++ b/lib/strftime.h
@@ -1,6 +1,6 @@
 /* declarations for strftime.c
 
-   Copyright (C) 2002, 2004 Free Software Foundation, Inc.
+   Copyright (C) 2002, 2004, 2008 Free Software Foundation, Inc.
 
    This program is free software: you can redistribute it and/or modify
    it under the terms of the GNU General Public License as published by
@@ -17,4 +17,10 @@
 
 #include <time.h>
 
-size_t nstrftime (char *, size_t, char const *, struct tm const *, int, int);
+/* Just like strftime, but with two more arguments:
+   POSIX requires that strftime use the local timezone information.
+   When __UTC is nonzero and tm->tm_zone is NULL or the empty string,
+   use UTC instead.  Use __NS as the number of nanoseconds in the
+   %N directive.  */
+size_t nstrftime (char *, size_t, char const *, struct tm const *,
+                 int __utc, int __ns);