Date: Mon, 10 Jul 2000 23:25:01 -0400 From: Bob Johnson <bobj@atlantic.net> To: Ben Smithurst <ben@FreeBSD.ORG>, freebsd-doc@FreeBSD.ORG Subject: Re: docs/18792: date man page has misleading description of -r option Message-ID: <3.0.6.32.20000710232501.00b2e9c0@rio.atlantic.net> In-Reply-To: <200007110150.SAA39221@freefall.freebsd.org>
next in thread | previous in thread | raw e-mail | index | archive | help
I prefer your version. My PR originally used _seconds_ to match the synopsis, but I agree that it is better to change the synopsis to match your improved wording. -- Bob At 06:50 PM 07/10/2000 -0700, Ben Smithurst wrote: >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 > > +-------------------------------------------------------- | Bob Johnson | bobj@atlantic.net +-------------------------------------------------------- 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?3.0.6.32.20000710232501.00b2e9c0>