Hi Michael,
On Sun, Jan 10, 2010 at 12:45 PM, Michael Witten [off-list ref] wrote:
The RFC 822-compliant date format given in the description of `%z'
is now moved to the `EXAMPLES' section (note: `EXAMPLE' has been
renamed `EXAMPLES').
Furthermore, that format example is now actually RFC 822-compliant
(using `%y' instead of `%Y') and has been qualified as being correct
only when in the context of at least an English locale. Also, `%T'
is used in place of `%H:%M:%S'.
For completeness, an RFC 2822-compliant format example has been
similarly added.
The formatting of the EXAMPLES section has been improved.
I've applied a slightly modified version of this patch (I reformatted
the pieces to do with the example program differently from what you
suggested).
Thanks!
Michael
quoted hunk
Signed-off-by: Michael Witten <redacted>
---
man3/strftime.3 | 30 +++++++++++++++++++++++-------
1 files changed, 23 insertions(+), 7 deletions(-)
diff --git a/man3/strftime.3 b/man3/strftime.3
index 0d925fa..bafe841 100644
--- a/man3/strftime.3
+++ b/man3/strftime.3
@@ -242,9 +242,7 @@ The year as a decimal number without a century (range 00 to 99).
The year as a decimal number including the century.
.TP
.B %z
-The +hhmm or -hhmm numeric time zone (that is, the hour and minute offset from UTC).
-Required to emit RFC\ 822-conformant dates
-(using "%a,\ %d\ %b\ %Y\ %H:%M:%S\ %z"). (SU)
+The +hhmm or -hhmm numeric time zone (that is, the hour and minute offset from UTC). (SU)
.TP
.B %Z
The timezone or name or abbreviation.
@@ -441,14 +439,30 @@ Nowadays,
.BR gcc (1)
provides the \fI\-Wno\-format\-y2k\fP option to prevent the warning,
so that the above workaround is no longer required.
-.SH EXAMPLE
+.SH EXAMPLES
+.BR "RFC\ 2822-compliant date format"
+(with an English locale for %a and %b)
+.PP
+.in +2n
+"%a,\ %d\ %b\ %Y\ %T\ %z"
+.PP
+.BR "RFC\ 822-compliant date format"
+(with an English locale for %a and %b)
+.PP
+.in +2n
+"%a,\ %d\ %b\ %y\ %T\ %z"
+.PP
+.BR "Sample program"
+.PP
+.in +2n
The program below can be used to experiment with
.BR strftime ().
.PP
+.in +2n
Some examples of the result string produced by the glibc implementation of
.BR strftime ()
are as follows:
-.in +4n
+.in +2n
.nf
.RB "$" " ./a.out \(aq%m\(aq"
@@ -457,9 +471,11 @@ Result string is "11"
Result string is "00011"
.RB "$" " ./a.out \(aq%_5m\(aq"
Result string is " 11"
+
.fi
-.in
-.SS Program source
+.in -2n
+Here is the program source:
+.in +2n
\&
.nf
#include <time.h>
--
1.6.6.102.gd6f8f
--
Michael Kerrisk
Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/
Author of "The Linux Programming Interface" http://blog.man7.org/
--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to majordomo-u79uwXL29TY76Z2rM5mHXA@public.gmane.org
More majordomo info at http://vger.kernel.org/majordomo-info.html