From owner-freebsd-doc  Mon Jul 10 20:27: 5 2000
Delivered-To: freebsd-doc@freebsd.org
Received: from mail.atlantic.net (mail.atlantic.net [209.208.0.71])
	by hub.freebsd.org (Postfix) with ESMTP
	id 85FE137BB75; Mon, 10 Jul 2000 20:27:01 -0700 (PDT)
	(envelope-from bobj@atlantic.net)
Received: from bsd.cisi.com (ocalflifanb-as-1-r1-ip-409.atlantic.net [209.208.29.155])
	by mail.atlantic.net (8.9.3/8.9.3) with ESMTP id XAA23745;
	Mon, 10 Jul 2000 23:26:58 -0400
Received: from nancy.cisi.com (nancy.cisi.com [192.168.0.131])
	by bsd.cisi.com (8.9.3/8.9.3) with SMTP id XAA34530;
	Mon, 10 Jul 2000 23:25:43 -0400 (EDT)
	(envelope-from bobj@atlantic.net)
Message-Id: <3.0.6.32.20000710232501.00b2e9c0@rio.atlantic.net>
X-Sender: bobj@rio.atlantic.net
X-Mailer: QUALCOMM Windows Eudora Light Version 3.0.6 (32)
Date: Mon, 10 Jul 2000 23:25:01 -0400
To: Ben Smithurst <ben@FreeBSD.ORG>, freebsd-doc@FreeBSD.ORG
From: Bob Johnson <bobj@atlantic.net>
Subject: Re: docs/18792: date man page has misleading description of -r
  option
In-Reply-To: <200007110150.SAA39221@freefall.freebsd.org>
Mime-Version: 1.0
Content-Type: text/plain; charset="us-ascii"
Sender: owner-freebsd-doc@FreeBSD.ORG
Precedence: bulk
X-Loop: FreeBSD.org

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