Bug 68861 - Man page strftime Confusingly Refers to Weekday Rather than Day of Week
Summary: Man page strftime Confusingly Refers to Weekday Rather than Day of Week
Status: RESOLVED CODE_FIX
Alias: None
Product: Documentation
Classification: Unclassified
Component: man-pages (show other bugs)
Hardware: All Linux
: P1 low
Assignee: documentation_man-pages@kernel-bugs.osdl.org
URL:
Keywords:
Depends on:
Blocks:
 
Reported: 2014-01-16 23:09 UTC by Brandon Edens
Modified: 2014-01-20 19:49 UTC (History)
1 user (show)

See Also:
Kernel Version:
Subsystem:
Regression: No
Bisected commit-id:


Attachments
Patch to man-pages archive. (646 bytes, patch)
2014-01-16 23:10 UTC, Brandon Edens
Details | Diff
Patch to man-pages-posix archive. (1.87 KB, patch)
2014-01-16 23:10 UTC, Brandon Edens
Details | Diff

Description Brandon Edens 2014-01-16 23:09:09 UTC
In several parts of the strftime page there are references to weekday which in several human cultures / locales specifies the set of the days of the week that are distinct from the set that represent the weekend.

To mitigate confusion, we propose that the man page text be modified so that the "weekday" text is changed to "day of week".
Comment 1 Brandon Edens 2014-01-16 23:10:08 UTC
Created attachment 122331 [details]
Patch to man-pages archive.
Comment 2 Brandon Edens 2014-01-16 23:10:39 UTC
Created attachment 122341 [details]
Patch to man-pages-posix archive.
Comment 3 Michael Kerrisk 2014-01-17 08:10:52 UTC
Brandon,

Note that we can't patch the POSIX pages. they are supplied to us by the standards committee. You could try raising an issue with the Austin group; not sure how far it would get though, since POSIX has been using this term for a long time now.

However, I do agree with the point that there is ambiguity here, and I've applied a slightly modified version of your patch.

I've also made a similar change in the following pages:

getdate.3
strptime.3
locale.5

Thanks for the report.

Cheers,

Michael
Comment 4 Brandon Edens 2014-01-20 19:49:56 UTC
That's great. Thanks Michael.

Note You need to log in before you can comment on or make changes to this bug.