mirror of https://github.com/mkerrisk/man-pages
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:
parent
32afd19741
commit
b458e1bfa7
|
@ -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"
|
||||
|
|
|
@ -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)
|
||||
|
|
|
@ -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
|
||||
|
|
Loading…
Reference in New Issue