Date: Tue, 11 Jul 2000 05:00:04 -0700 (PDT) From: Jeroen Ruigrok van der Werven <jruigrok@via-net-works.nl> To: freebsd-doc@freebsd.org Subject: Re: docs/18792: date man page has misleading description of -r option Message-ID: <200007111200.FAA33113@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: Jeroen Ruigrok van der Werven <jruigrok@via-net-works.nl> To: Ben Smithurst <ben@FreeBSD.org> Cc: freebsd-gnats-submit@FreeBSD.org, bobj@atlantic.net Subject: Re: docs/18792: date man page has misleading description of -r option Date: Tue, 11 Jul 2000 13:58:20 +0200 -On [20000711 13:55], Ben Smithurst (ben@FreeBSD.org) wrote: >Jeroen Ruigrok/Asmodai wrote: > >> Yeah, the change might make it more clear for non native english >> speakers (and probably the english ones as well). >> >> It looks clearer to me. >> >> But don't forget that: >> >> [8:36] [asmodai@daemon] (356) $ date ? >> date: illegal time format >> usage: date [-nu] [-d dst] [-r seconds] [-t west] [-v[+|-]val[ymwdHMS]] ... >> [-f fmt date | [[[[[cc]yy]mm]dd]HH]MM[.ss]] [+format] >> >> You cannot change the function arguments (.Fa) around for sake of >> clarity, since it would now conflict with the shown arguments. =) > >hmm, ok. I suppose .c files are out of my allowed area? Not really. But sometimes changes need not be that drastically. ;) When you have a hammer, everything looks like a nail. >> I am sure you can find another wording for the paragraph which solves > >I thought of something like > >"Print the date and time which is the specified number of seconds from the >Epoch." > >but then you wouldn't be showing the function argument (with .Ar >seconds) so that might not be right. If you used .Ar on the 'seconds' >in that sentence it wouldn't be right either. > >"Print the data and time which is the specified time, _seconds_, from the >Epoch." Print the date and time, specified by x _seconds_ from the Epoch? -- Jeroen Ruigrok van der Werven Network- and systemadministrator <jruigrok@via-net-works.nl> VIA Net.Works The Netherlands BSD: Technical excellence at its best http://www.via-net-works.nl ``...by God I *KNOW* what this network is for, and you can't have it.'' -- Russ Albery 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?200007111200.FAA33113>