Re:Strftime's alpha-sorted man page vs. well-meaning people
by paultopia on Sunday May 13, 2018 @09:42AM
(#17058852)
The problem is that this text makes no sense standing alone... why would anyone imagine that a week number might belong to a year other than the year it's in without a separate detailed explanation?
Re:Strftime's alpha-sorted man page vs. well-meaning people
by twic on Sunday May 13, 2018 @11:23AM
(#17059362)
I agree that most people, on reading it, wouldn't understand exactly what it meant. But i think an adequately sharp person would think "i don't understand exactly what that means, so i'm going to find out before i use it".
A person whose response is "i don't understand exactly what that means, but it sounds close, so i'm going to use it" should probably not be doing detail work like programming.
Re:Strftime's alpha-sorted man page vs. well-meaning people
by samatman on Sunday May 13, 2018 @12:53PM
(#17059814)
> This has the same format and value as %Y
When I see a line like that, I check %Y immediately.
Unless I'm tired, in a hurry, or just not paying enough attention.
Re:Strftime's alpha-sorted man page vs. well-meaning people
by gpvos on Sunday May 13, 2018 @01:42PM
(#17060019)
...which happens to many people once in a while...
Re:Strftime's alpha-sorted man page vs. well-meaning people
by kazinator on Sunday May 13, 2018 @05:48PM
(#17061215)
The text makes it clear that the week can belong to another year. This piece of documentation leaks numerous clues that it's describing something radioactive that you want to stay away from
And it gives away the specifier that you want: %Y.
"Same format as %Y except ..." means "this is some extended/twisted version of another year format, which is assigned to the obvious %Y letter. Hmm, maybe I should check that one out!"
"This has the same format and value as %Y, except that if the ISO week number belongs to the previous or next year, that year is used instead. (TZ (Calculated from tm_year, tm_yday, and tm_wday.)"
[0]: http://man7.org/linux/man-pages/man3/strftime.3.html