[EMAIL PROTECTED] (Ludovic Courtès) wrote:
> [EMAIL PROTECTED] (Ludovic Courtès) writes:
>
>> I'm trying to fix a portability bug related to `strftime(3)' [0]. The
>> `strftime' module doesn't provide `strftime ()' as one would expect but
>> instead provides `nstrftime ()', with additional arguments:
>> int ut, int ns. What are these arguments about?
>
> I just remembered I didn't get an answer to the above question. :-)
>
> (Since I'm too lazy I think I'd rather use `nstrftime ()' than write a
> new module providing `strftime ()'.)
Here's some long-overdue documentation:
>From 4bb481aef2793a2cd25d61113d58da42af2bf8a8 Mon Sep 17 00:00:00 2001
From: Jim Meyering <[EMAIL PROTECTED]>
Date: Sun, 31 Aug 2008 17:34:24 +0200
Subject: [PATCH] * lib/strftime.h: Add comments describing the two added
arguments.
---
ChangeLog | 2 ++
lib/strftime.h | 10 ++++++++--
2 files changed, 10 insertions(+), 2 deletions(-)
diff --git a/ChangeLog b/ChangeLog
index 99ab461..4592840 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,5 +1,7 @@
2008-08-31 Jim Meyering <[EMAIL PROTECTED]>
+ * 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
--- 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);
--
1.6.0.1.157.g7df43
