[PATCH 5/9] strftime.3: Move 822-compliant date format example to EXAMPLES section

[Michael Witten <mfwitten-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org>]

The RFC 822-compliant date format given in the description of `%z'
is now moved to the EXAMPLE section (and 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.

Signed-off-by: Michael Witten <mfwitten-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org>
---

                   WOOPS!

Somehow I managed to produce a commit without actually
having changed `EXAMPLE' to `EXAMPLES'. This version
fixes that.


 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.5.2.180.gc5b3e

--
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