getdate.3, strptime.3, locale.5: Replace "weekday" with less ambiguous language

Notwithstanding POSIX's use of the term "weekday", in everyday
English, "weekday" is commonly understood to mean a day in the
set [Monday..Friday] (vs one of the "weekend" days).

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
This commit is contained in:
Michael Kerrisk 2014-01-17 21:08:16 +13:00
parent 32afd19741
commit b458e1bfa7
3 changed files with 12 additions and 11 deletions

View File

@ -27,7 +27,7 @@
.\" Modified, 2001-12-26, aeb
.\" 2008-09-07, mtk, Various rewrites; added an example program.
.\"
.TH GETDATE 3 2013-06-21 "" "Linux Programmer's Manual"
.TH GETDATE 3 2014-01-17 "" "Linux Programmer's Manual"
.SH NAME
getdate, getdate_r \- convert a date-plus-time string to broken-down time
.SH SYNOPSIS
@ -109,7 +109,8 @@ Otherwise, the structure is initialized to the broken-down time
corresponding to the current local time (as by a call to
.BR localtime (3)).
.LP
When only the weekday is given, the day is taken to be the first such day
When only the day of the week is given,
the day is taken to be the first such day
on or after today.
.LP
When only the month is given (and no year), the month is taken to
@ -229,7 +230,7 @@ The following shell session demonstrates the operation of the program:
.in +4n
.nf
.RB "$" " TFILE=$PWD/tfile"
.RB "$" " echo \(aq%A\(aq > $TFILE " " # Full weekday name"
.RB "$" " echo \(aq%A\(aq > $TFILE " " # Full name of the day of the week"
.RB "$" " echo \(aq%T\(aq >> $TFILE" " # ISO date (YYYY-MM-DD)"
.RB "$" " echo \(aq%F\(aq >> $TFILE" " # Time (HH:MM:SS)"
.RB "$" " date"

View File

@ -28,7 +28,7 @@
.\" Modified, aeb, 2001-08-31
.\" Modified, wharms 2001-11-12, remark on white space and example
.\"
.TH STRPTIME 3 2013-12-30 "GNU" "Linux Programmer's Manual"
.TH STRPTIME 3 2014-01-17 "GNU" "Linux Programmer's Manual"
.SH NAME
strptime \- convert a string representation of time to a time tm structure
.SH SYNOPSIS
@ -107,7 +107,7 @@ If the input cannot be matched to the format string the function stops.
The remainder of the format and input strings are not processed.
.PP
The supported input field descriptors are listed below.
In case a text string (such as a weekday or month name)
In case a text string (such as the name of a day of the week or a month name)
is to be matched, the comparison is case insensitive.
In case a number is to be matched, leading zeros are
permitted but not required.
@ -118,7 +118,7 @@ The
character.
.TP
.BR %a " or " %A
The weekday name according to the current locale,
The name of the day of the week according to the current locale,
in abbreviated form or the full name.
.TP
.BR %b " or " %B " or " %h
@ -197,7 +197,7 @@ The week number with Sunday the first day of the week (0-53).
The first Sunday of January is the first day of week 1.
.TP
.B %w
The weekday number (0-6) with Sunday = 0.
The ordinal number of the day of the week (0-6), with Sunday = 0.
.TP
.B %W
The week number with Monday the first day of the week (0-53).
@ -274,8 +274,8 @@ The week number of the year (Sunday as the first day of the week)
using the locale's alternative numeric symbols.
.TP
.B %Ow
The number of the weekday (Sunday=0) using the locale's alternative
numeric symbols.
The ordinal number of the day of the week (Sunday=0),
using the locale's alternative numeric symbols.
.TP
.B %OW
The week number of the year (Monday as the first day of the week)

View File

@ -496,14 +496,14 @@ in the first column.
The following keywords are allowed:
.TP
.I abday
followed by a list of abbreviated weekday names.
followed by a list of abbreviated names of the days of the week.
The list starts with the first day of the week
as specified by
.I week
(Sunday by default).
.TP
.I day
followed by a list of weekday names.
followed by a list of names of the days of the week.
The list starts with the first day of the week
as specified by
.I week