From nobody@FreeBSD.ORG  Wed May 24 08:12:25 2000
Return-Path: <nobody@FreeBSD.ORG>
Received: by hub.freebsd.org (Postfix, from userid 32767)
	id EC12537BC74; Wed, 24 May 2000 08:12:25 -0700 (PDT)
Message-Id: <20000524151225.EC12537BC74@hub.freebsd.org>
Date: Wed, 24 May 2000 08:12:25 -0700 (PDT)
From: bobj@atlantic.net
Sender: nobody@FreeBSD.ORG
To: freebsd-gnats-submit@FreeBSD.org
Subject: date man page has misleading description of -r option
X-Send-Pr-Version: www-1.0

>Number:         18792
>Category:       docs
>Synopsis:       date man page has misleading description of -r option
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Wed May 24 08:20:00 PDT 2000
>Closed-Date:    Sat Jul 15 09:51:35 PDT 2000
>Last-Modified:  Tue Apr 29 06:10:01 UTC 2014
>Originator:     Bob Johnson
>Release:        3.4-STABLE FreeBSD 3.4-STABLE #2: Mon Mar 27
>Organization:
>Environment:
>Description:
"man date" says

 -r      Print out the date and time in seconds from the Epoch. 

which isn't really accurate.	It prints the time that is a 
user-specified number of seconds from the Epoch.

>How-To-Repeat:
man date

Note that synopsis specifies _seconds_ argument to the -r option.

>Fix:
Change it to say 

 -r     Print out the date and time that is _seconds_ seconds from the Epoch.



>Release-Note:
>Audit-Trail:

From: Rasmus Kaj <kaj@raditex.se>
To: freebsd-gnats-submit@FreeBSD.org, bobj@atlantic.net
Cc: Rasmus Kaj <kaj@raditex.se>
Subject: Re: docs/18792: date man page has misleading description of -r option
Date: 26 Jun 2000 20:28:52 +0200

 I agree, so heres a diff for /usr/src/bin/date/date.1, in case someone
 with a commit bit also agrees:
 
 -- start of diff --
 --- date.1.orig Mon Jun 26 20:25:02 2000
 +++ date.1      Mon Jun 26 20:23:17 2000
 @@ -92,9 +92,9 @@
  .Nm
  from setting the time for other than the current machine.
  .It Fl r
 -Print out the date and time in
 +Print out the date and time that is
  .Ar seconds
 -from the Epoch.
 +seconds from the Epoch.
  .It Fl t
  Set the kernel's value for minutes west of
  .Tn GMT .
 -- end of diff --
 
 -- 
 Rasmus Kaj -------------------- rasmus@kaj.se - http://Raditex.se/~kaj/
  \                      Machines should work. People should think. -IBM
   \------------------------------------------------- http://Raditex.se/
 
State-Changed-From-To: open->closed  
State-Changed-By: dannyboy 
State-Changed-When: Fri Jul 7 18:35:42 PDT 2000 
State-Changed-Why:  


http://www.freebsd.org/cgi/query-pr.cgi?pr=18792 
State-Changed-From-To: closed->open  
State-Changed-By: dannyboy 
State-Changed-When: Fri Jul 7 18:41:54 PDT 2000 
State-Changed-Why:  
AARGH.  Sorry, shouldn't have closed this. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=18792 

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
 

From: Jeroen Ruigrok/Asmodai <asmodai@FreeBSD.org>
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 08:38:18 +0200

 -On [20000711 04:01], Ben Smithurst (ben@FreeBSD.org) wrote:
 >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
 
 [snip]
 
 >	-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.
 
 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. =)
 I am sure you can find another wording for the paragraph which solves
 this riddle.
 
 -- 
 Jeroen Ruigrok vd Werven/Asmodai    asmodai@[wxs.nl|bart.nl|freebsd.org]
 Documentation nutter/C-rated Coder BSD: Technical excellence at its best  
 The BSD Programmer's Documentation Project <http://home.wxs.nl/~asmodai>
 So take a look at me now, well there's just an empty space...
 

From: Ben Smithurst <ben@FreeBSD.org>
To: Jeroen Ruigrok/Asmodai <asmodai@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 12:47:42 +0100

 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?
 
 > 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."
 
 A bit better, perhaps.
 
 -- 
 Ben Smithurst / ben@FreeBSD.org / PGP: 0x99392F7D
 

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
 

From: Ben Smithurst <ben@FreeBSD.org>
To: Jeroen Ruigrok van der Werven <jruigrok@via-net-works.nl>
Cc: freebsd-gnats-submit@FreeBSD.org, bobj@atlantic.net
Subject: Re: docs/18792: date man page has misleading description of -r option
Date: Wed, 12 Jul 2000 02:30:31 +0100

 Jeroen Ruigrok van der Werven wrote:
 
 > Print the date and time, specified by x _seconds_ from the Epoch?
 
 Hmm, I don't like the "x".  This manpage was changed relatively recently
 anyway to be less confusing:
 
 ===
 revision 1.34
 date: 2000/03/07 20:54:17;  author: sheldonh;  state: Exp;  lines: +8 -3
 branches:  1.34.2;
 Correct confusing description of the -r option.
 
 PR:             17250
 Submitted by:   cjclark@home.com (Crist J. Clark)
 ===
 
 And I think the current text is ok, to be honest, certainly better than
 it was.  We're going round in circles trying to find something better
 anyway, and I think Sheldon knows what he's doing. :-) Also, there's
 another PR (18880, unassigned) which suggested bringing in a load of
 enhancements to the date(1) manpage from OpenBSD, which might address
 this.  I think the PR should either be closed, or we should change the
 usage() and SYNOPSIS so it can say "... _sec_ seconds ..." since that's
 the only version I'm really happy with.
 
 -- 
 Ben Smithurst / ben@FreeBSD.org / PGP: 0x99392F7D
 

From: parish <stonewall@btinternet.com>
To: freebsd-gnats-submit@FreeBSD.org
Cc:  
Subject: Re: docs/18792: date man page has misleading description of -r option
Date: Thu, 13 Jul 2000 20:10:47 +0100

 How about:
 
 	-r print out the date and time represented by _seconds_, which is
 	   the number of seconds since the Epoch (00:00:00 UTC, January 1,
 	   1970; see time(3))
 
 or
 
 	-r print _seconds_ as a date and time, where _seconds_ is the number of
 	   seconds since the Epoch (00:00:00 UTC, January 1, 1970; see
 time(3)).
 
 -- 
   If I buy a copy of WinDelete, and it doesn't delete Windows,
   am I entitled to my money back?
 ________________________________________________________________
       FreeBSD - The Power To Serve http://www.freebsd.org
       My Webpage http://ukug.uk.freebsd.org/~mark/
 mailto:marko@freebsd.org             http://www.radan.com
 
State-Changed-From-To: open->closed 
State-Changed-By: marko 
State-Changed-When: Sat Jul 15 09:51:35 PDT 2000 
State-Changed-Why:  
Committed with minor changes, Thanks! 

http://www.freebsd.org/cgi/query-pr.cgi?pr=18792 

From: dfilter@FreeBSD.ORG (dfilter service)
To: bug-followup@FreeBSD.org
Cc:  
Subject: Re: docs/18792: commit references a PR
Date: Tue, 29 Apr 2014 06:00:09 +0000 (UTC)

 Author: miwi
 Date: Tue Apr 29 06:00:06 2014
 New Revision: 352577
 URL: http://svnweb.freebsd.org/changeset/ports/352577
 QAT: https://qat.redports.org/buildarchive/r352577/
 
 Log:
   - Force commit to fix prev entry
   - Update to version 2.2.3
   
   PR:		18792
   Submitted by:	ports fury
 
 Modified:
   head/irc/scrollz/Makefile
 
 Modified: head/irc/scrollz/Makefile
 ==============================================================================
 --- head/irc/scrollz/Makefile	Tue Apr 29 05:57:28 2014	(r352576)
 +++ head/irc/scrollz/Makefile	Tue Apr 29 06:00:06 2014	(r352577)
 @@ -1,6 +1,6 @@
  # Created by: Will Andrews <andrews@technologist.com>
  # $FreeBSD$
 -
 + 
  PORTNAME=	scrollz
  PORTVERSION=	2.2.3
  CATEGORIES=	irc ipv6
 _______________________________________________
 svn-ports-all@freebsd.org mailing list
 http://lists.freebsd.org/mailman/listinfo/svn-ports-all
 To unsubscribe, send any mail to "svn-ports-all-unsubscribe@freebsd.org"
 
>Unformatted:
