From owner-freebsd-doc Mon Jul 10 18:50: 6 2000 Delivered-To: freebsd-doc@freebsd.org Received: from freefall.freebsd.org (freefall.FreeBSD.ORG [204.216.27.21]) by hub.freebsd.org (Postfix) with ESMTP id AB90F37B7B3 for ; Mon, 10 Jul 2000 18:50:02 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.9.3/8.9.2) id SAA39221; Mon, 10 Jul 2000 18:50:02 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Date: Mon, 10 Jul 2000 18:50:02 -0700 (PDT) Message-Id: <200007110150.SAA39221@freefall.freebsd.org> To: freebsd-doc@freebsd.org Cc: From: Ben Smithurst Subject: Re: docs/18792: date man page has misleading description of -r option Reply-To: Ben Smithurst Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org The following reply was made to PR docs/18792; it has been noted by GNATS. From: Ben Smithurst 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