Date: Mon, 10 Jul 2000 18:50:02 -0700 (PDT) From: Ben Smithurst <ben@FreeBSD.org> To: freebsd-doc@freebsd.org Subject: Re: docs/18792: date man page has misleading description of -r option Message-ID: <200007110150.SAA39221@freefall.freebsd.org>
next in thread | raw e-mail | index | archive | help
The following reply was made to PR docs/18792; it has been noted by GNATS.
From: Ben Smithurst <ben@FreeBSD.org>
To: freebsd-gnats-submit@FreeBSD.org, bobj@atlantic.net,
asmodai@FreeBSD.org
Cc:
Subject: Re: docs/18792: date man page has misleading description of -r option
Date: Tue, 11 Jul 2000 02:42:16 +0100
The man page now says:
-r Print out the date and time that is seconds from the Epoch
(00:00:00 UTC, January 1, 1970; see time(3)).
I'm not sure when this was changed, but is that any better? I don't
really like it because it's not valid English really, although it makes
more sense in the real manpage because _seconds_ is underlined. Still,
I'd prefer the following:
--- date.1 2000/06/28 09:20:06 1.39
+++ date.1 2000/07/11 01:32:00
@@ -45,7 +45,7 @@
.Nm date
.Op Fl jnu
.Op Fl d Ar dst
-.Op Fl r Ar seconds
+.Op Fl r Ar sec
.Op Fl t Ar minutes_west
.Oo
.Fl v
@@ -113,7 +113,8 @@
from setting the time for other than the current machine.
.It Fl r
Print out the date and time that is
-.Ar seconds
+.Ar sec
+seconds
from the Epoch
.Po
00:00:00 UTC, January 1, 1970;
So you'll get
SYNOPSIS
date ... [-r sec] ...
...
-r Print out the date and time that is _sec_ seconds ...
Is that ok? If Jeroen (my mentor) approves this and no-one objects then
I'll commit it. If people think the current text is fine I'll just
close the PR.
--
Ben Smithurst / ben@FreeBSD.org / PGP: 0x99392F7D
To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?200007110150.SAA39221>