summaryrefslogtreecommitdiffstats
path: root/bin/date
diff options
context:
space:
mode:
authorru <ru@FreeBSD.org>2001-08-07 15:48:51 +0000
committerru <ru@FreeBSD.org>2001-08-07 15:48:51 +0000
commit43457588767caedd16dbf19162de0a6a435dfeda (patch)
tree0505e005ecc9492a4b759dc8e06eb138613e4aa4 /bin/date
parent6b00d6a3ebd552afe7b0a0844e598ee70810f887 (diff)
downloadFreeBSD-src-43457588767caedd16dbf19162de0a6a435dfeda.zip
FreeBSD-src-43457588767caedd16dbf19162de0a6a435dfeda.tar.gz
mdoc(7) police:
Avoid using parenthesis enclosure macros (.Pq and .Po/.Pc) with plain text. Not only this slows down the mdoc(7) processing significantly, but it also has an undesired (in this case) effect of disabling hyphenation within the entire enclosed block.
Diffstat (limited to 'bin/date')
-rw-r--r--bin/date/date.126
1 files changed, 11 insertions, 15 deletions
diff --git a/bin/date/date.1 b/bin/date/date.1
index a8a1203..4bbb990 100644
--- a/bin/date/date.1
+++ b/bin/date/date.1
@@ -160,13 +160,11 @@ The date can be adjusted as many times as required using these flags.
Flags are processed in the order given.
.Pp
When setting values
-.Pq rather than adjusting them ,
+(rather than adjusting them),
seconds are in the range 0-59, minutes are in the range 0-59, hours are
in the range 1-12, month days are in the range 1-31, week days are in the
-range 0-6
-.Pq Sun-Sat ,
-months are in the range 1-12
-.Pq Jan-Dec
+range 0-6 (Sun-Sat),
+months are in the range 1-12 (Jan-Dec)
and years are in the range 80-38 or 1980-2038.
.Pp
If
@@ -185,11 +183,11 @@ must be used to specify which part of the date is to be adjusted.
The week day or month may be specified using a name rather than a
number.
If a name is used with the plus
-.Pq or minus
+(or minus)
sign, the date will be put forwards
-.Pq or backwards
+(or backwards)
to the next
-.Pq previous
+(previous)
date that matches the given week day or month.
This will not adjust the date,
if the given week day or month is the same as the current one.
@@ -207,13 +205,11 @@ the clock goes back at 02:00 to 01:00, using
will be necessary to reach October 29, 2:30.
.Pp
When the date is adjusted to a specific value that doesn't actually exist
-.Po
-for example March 26, 1:30 BST 2000 in the Europe/London timezone
-.Pc ,
+(for example March 26, 1:30 BST 2000 in the Europe/London timezone),
the date will be silently adjusted forwards in units of one hour until it
reaches a valid time.
When the date is adjusted to a specific value that occurs twice
-.Pq for example October 29, 1:30 2000 ,
+(for example October 29, 1:30 2000),
the resulting timezone will be set so that the date matches the earlier of
the two times.
.Pp
@@ -242,11 +238,11 @@ The canonical representation for setting the date and time is:
.Bl -tag -width Ds -compact -offset indent
.It Ar cc
Century
-.Pq either 19 or 20
+(either 19 or 20)
prepended to the abbreviated year.
.It Ar yy
Year in abbreviated form
-.Pq e.g. 89 for 1989, 06 for 2006 .
+(e.g. 89 for 1989, 06 for 2006).
.It Ar mm
Numeric month, a number from 1 to 12.
.It Ar dd
@@ -257,7 +253,7 @@ Hour, a number from 0 to 23.
Minutes, a number from 0 to 59.
.It Ar ss
Seconds, a number from 0 to 61
-.Pq 59 plus a maximum of two leap seconds .
+(59 plus a maximum of two leap seconds).
.El
.Pp
Everything but the minutes is optional.
OpenPOWER on IntegriCloud