From: Marco Atzeri <marco.atzeri@gmail.com>
To: cygwin@cygwin.com
Subject: Re: strftime man page is garbled
Date: Thu, 04 Jun 2015 05:32:00 -0000 [thread overview]
Message-ID: <556FE2DA.7040505@gmail.com> (raw)
In-Reply-To: <556FA760.7040501@acm.org>
[-- Attachment #1: Type: text/plain, Size: 1220 bytes --]
On 6/4/2015 3:18 AM, Wayne Pollock wrote:
> The description section of the strftime man page is
> garbled. The first paragraph shows as this:
>
> =============================
>
> into a null-terminated string, starting at S and occupying no more than
> MAXSIZE characters.
>
> You control the format of the output using the string at FORMAT.
> literally into the formatted string, and
> time conversion specifications. Time conversion specifications are two- and
> three-character sequences beginâ
> ning with ''%'' (use ''%%'' to include a percent sign in the output). Each
> defined conversion specification
> selects only the specified field(s) of calendar time data from '*TIMP', and
> converts it to a string in one of
> the following ways:
>
> ============================
>
> In addition, none of the option letters show, only the
> option descriptions. The info node at
> "info libc timefns strftime" appears to be fine.
>
> I have cygwin-doc version 1.7.35-1.
> (I have a locale of C.UTF-8, if it matters.)
>
Works fine for me, I have a complete man page
see attached.
looks at the output of
man -d strftime
for any hint.
Regards
Marco
[-- Warning: decoded text below may be mangled, UTF-8 assumed --]
[-- Attachment #2: man-strftime.txt --]
[-- Type: text/plain; charset=windows-1252; name="man-strftime.txt", Size: 9940 bytes --]
STRFTIME(3) NEWLIB STRFTIME(3)
NAME
9.8 'strftime'--convert date and time to a formatted string
SYNOPSIS
#include <time.h>
size_t strftime(char *restrict S, size_t MAXSIZE,
const char *restrict FORMAT,
const struct tm *restrict TIMP);
DESCRIPTION
into a null-terminated string, starting at S and occupying no more than
MAXSIZE characters.
You control the format of the output using the string at FORMAT.
literally into the formatted string, and time conversion specifica‐
tions. Time conversion specifications are two- and three-character
sequences beginning with ''%'' (use ''%%'' to include a percent sign in
the output). Each defined conversion specification selects only the
specified field(s) of calendar time data from '*TIMP', and converts it
to a string in one of the following ways:
The abbreviated weekday name according to the current locale.
[tm_wday]
The full weekday name according to the current locale. In the
default "C" locale, one of ''Sunday'', ''Monday'', ''Tuesday'',
''Wednesday'', ''Thursday'', ''Friday'', ''Saturday''. [tm_wday]
The abbreviated month name according to the current locale.
[tm_mon]
The full month name according to the current locale. In the
default "C" locale, one of ''January'', ''February'', ''March'',
''April'', ''May'', ''June'', ''July'', ''August'', ''September'',
''October'', ''November'', ''December''. [tm_mon]
The preferred date and time representation for the current locale.
[tm_sec, tm_min, tm_hour, tm_mday, tm_mon, tm_year, tm_wday]
The century, that is, the year divided by 100 then truncated. For
4-digit years, the result is zero-padded and exactly two
characters; but for other years, there may a negative sign or more
digits. In this way, ''%C%y'' is equivalent to ''%Y''. [tm_year]
The day of the month, formatted with two digits (from ''01'' to
''31''). [tm_mday]
A string representing the date, in the form ''"%m/%d/%y"''.
[tm_mday, tm_mon, tm_year]
The day of the month, formatted with leading space if single digit
(from ''1'' to ''31''). [tm_mday]
In some locales, the E modifier selects alternative representa‐
tions
of certain modifiers 'x'. In newlib, it is ignored, and treated
as
%'x'.
A string representing the ISO 8601:2000 date format, in the form
''"%Y-%m-%d"''. [tm_mday, tm_mon, tm_year]
The last two digits of the week-based year, see specifier %G (from
''00'' to ''99''). [tm_year, tm_wday, tm_yday]
The week-based year. In the ISO 8601:2000 calendar, week 1 of the
year includes January 4th, and begin on Mondays. Therefore, if
January 1st, 2nd, or 3rd falls on a Sunday, that day and earlier
belong to the last week of the previous year; and if December
29th,
30th, or 31st falls on Monday, that day and later belong to week 1
of the next year. For consistency with %Y, it always has at least
four characters. Example: "%G" for Saturday 2nd January 1999
gives
"1998", and for Tuesday 30th December 1997 gives "1998".
[tm_year,
tm_wday, tm_yday]
Synonym for "%b". [tm_mon]
The hour (on a 24-hour clock), formatted with two digits (from
''00'' to ''23''). [tm_hour]
The hour (on a 12-hour clock), formatted with two digits (from
''01'' to ''12''). [tm_hour]
The count of days in the year, formatted with three digits (from
''001'' to ''366''). [tm_yday]
The hour (on a 24-hour clock), formatted with leading space if
single digit (from ''0'' to ''23''). Non-POSIX extension (c.p.
%I). [tm_hour]
The hour (on a 12-hour clock), formatted with leading space if
single digit (from ''1'' to ''12''). Non-POSIX extension (c.p.
%H). [tm_hour]
The month number, formatted with two digits (from ''01'' to
''12''). [tm_mon]
The minute, formatted with two digits (from ''00'' to ''59'').
[tm_min]
A newline character (''0').
In some locales, the O modifier selects alternative digit
characters for certain modifiers 'x'. In newlib, it is ignored,
and treated as %'x'.
Either ''AM'' or ''PM'' as appropriate, or the corresponding
strings for the current locale. [tm_hour]
Same as ''%p'', but in lowercase. This is a GNU extension.
[tm_hour]
Replaced by the time in a.m. and p.m. notation. In the "C"
locale this is equivalent to "%I:%M:%S %p". In locales which
don't
define a.m./p.m. notations, the result is an empty string.
[tm_sec, tm_min, tm_hour]
The 24-hour time, to the minute. Equivalent to "%H:%M". [tm_min,
tm_hour]
The second, formatted with two digits (from ''00'' to ''60'').
The
value 60 accounts for the occasional leap second. [tm_sec]
A tab character ('''').
The 24-hour time, to the second. Equivalent to "%H:%M:%S".
[tm_sec, tm_min, tm_hour]
The weekday as a number, 1-based from Monday (from ''1'' to
''7'').
[tm_wday]
The week number, where weeks start on Sunday, week 1 contains the
first Sunday in a year, and earlier days are in week 0. Formatted
with two digits (from ''00'' to ''53''). See also '%W'.
[tm_wday,
tm_yday]
The week number, where weeks start on Monday, week 1 contains
January 4th, and earlier days are in the previous year. Formatted
with two digits (from ''01'' to ''53''). See also '%G'.
[tm_year,
tm_wday, tm_yday]
The weekday as a number, 0-based from Sunday (from ''0'' to
''6'').
[tm_wday]
The week number, where weeks start on Monday, week 1 contains the
first Monday in a year, and earlier days are in week 0. Formatted
with two digits (from ''00'' to ''53''). [tm_wday, tm_yday]
Replaced by the preferred date representation in the current
locale. In the "C" locale this is equivalent to "%m/%d/%y".
[tm_mon, tm_mday, tm_year]
Replaced by the preferred time representation in the current
locale. In the "C" locale this is equivalent to "%H:%M:%S".
[tm_sec, tm_min, tm_hour]
The last two digits of the year (from ''00'' to ''99'').
[tm_year]
(Implementation interpretation: always positive, even for negative
years.)
The full year, equivalent to '%C%y'. It will always have at least
four characters, but may have more. The year is accurate even
when
tm_year added to the offset of 1900 overflows an int. [tm_year]
The offset from UTC. The format consists of a sign (negative is
west of Greewich), two characters for hour, then two characters
for
minutes (-hhmm or +hhmm). If tm_isdst is negative, the offset is
unknown and no output is generated; if it is zero, the offset is
the standard offset for the current time zone; and if it is
positive, the offset is the daylight savings offset for the cur‐
rent
timezone. The offset is determined from the TZ environment
variable, as if by calling tzset(). [tm_isdst]
The time zone name. If tm_isdst is negative, no output is
generated. Otherwise, the time zone name is based on the TZ
environment variable, as if by calling tzset(). [tm_isdst]
A single character, ''%''.
RETURNS
When the formatted time takes up no more than MAXSIZE characters, the
result is the length of the formatted string. Otherwise, if the for‐
matting operation was abandoned due to lack of room, the result is
PORTABILITY
ANSI C requires 'strftime', but does not specify the contents of '*S'
when the formatted string would require more than MAXSIZE characters.
Unrecognized specifiers and fields of 'timp' that are out of range
cause undefined results. Since some formats expand to 0 bytes, it is
wise to set '*S' to a nonzero value beforehand to distinguish between
failure and an empty string. This implementation does not support 's'
being NULL, nor overlapping 's' and 'format'.
'strftime' requires no supporting OS subroutines.
*Bugs* hard-coding the "C" locale settings.
SEE ALSO
strftime is part of the libc:_(libc)._the_ansi_c_library. library.
The full documentation for libc:_(libc)._the_ansi_c_library. is main‐
tained as a Texinfo manual. If info and
libc:_(libc)._the_ansi_c_library. are properly installed at your site,
the command
info libc:_(libc)._the_ansi_c_library.
will give you access to the complete manual.
NEWLIB March 2015 STRFTIME(3)
[-- Attachment #3: Type: text/plain, Size: 218 bytes --]
--
Problem reports: http://cygwin.com/problems.html
FAQ: http://cygwin.com/faq/
Documentation: http://cygwin.com/docs.html
Unsubscribe info: http://cygwin.com/ml/#unsubscribe-simple
next prev parent reply other threads:[~2015-06-04 5:32 UTC|newest]
Thread overview: 11+ messages / expand[flat|nested] mbox.gz Atom feed top
2015-06-04 1:18 Wayne Pollock
2015-06-04 5:32 ` Marco Atzeri [this message]
2015-06-04 5:46 ` Achim Gratz
2015-06-04 6:27 ` Marco Atzeri
2015-06-04 13:11 ` Nellis, Kenneth
2015-06-04 14:34 ` Jon TURNEY
2015-06-04 14:50 ` Eric Blake
2015-06-05 12:26 ` Jon TURNEY
2015-06-04 15:03 ` Marco Atzeri
2015-06-04 15:43 ` Nellis, Kenneth
2015-06-05 11:56 ` Jon TURNEY
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=556FE2DA.7040505@gmail.com \
--to=marco.atzeri@gmail.com \
--cc=cygwin@cygwin.com \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).