From swear@blarg.net  Wed Mar  6 15:33:30 2002
Return-Path: <swear@blarg.net>
Received: from lists.blarg.net (lists.blarg.net [206.124.128.17])
	by hub.freebsd.org (Postfix) with ESMTP id 2ABFE37B402
	for <FreeBSD-gnats-submit@freebsd.org>; Wed,  6 Mar 2002 15:33:30 -0800 (PST)
Received: from thig.blarg.net (thig.blarg.net [206.124.128.18])
	by lists.blarg.net (Postfix) with ESMTP id DD284BD10
	for <FreeBSD-gnats-submit@freebsd.org>; Wed,  6 Mar 2002 15:33:29 -0800 (PST)
Received: from localhost.localdomain ([206.124.139.115])
	by thig.blarg.net (8.9.3/8.9.3) with ESMTP id PAA09958
	for <FreeBSD-gnats-submit@freebsd.org>; Wed, 6 Mar 2002 15:33:28 -0800
Received: (from jojo@localhost)
	by localhost.localdomain (8.11.6/8.11.3) id g26Nakg41969;
	Wed, 6 Mar 2002 15:36:46 -0800 (PST)
	(envelope-from swear@blarg.net)
Message-Id: <i1ofi1feup.fi1@localhost.localdomain>
Date: 06 Mar 2002 15:36:46 -0800
From: "Gary W. Swearingen" <swear@blarg.net>
Reply-To: swear@blarg.net
To: FreeBSD-gnats-submit@freebsd.org
Subject: date(1) page doesn't say which clock(s) it sets.
X-GNATS-Notify:

>Number:         35606
>Category:       docs
>Synopsis:       date(1) page doesn't say which clock(s) it sets.
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    trhodes
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Wed Mar 06 15:40:01 PST 2002
>Closed-Date:    Wed Apr 17 07:53:26 PDT 2002
>Last-Modified:  Wed Apr 17 07:53:26 PDT 2002
>Originator:     Gary W. Swearingen
>Release:        FreeBSD 4.5-STABLE i386
>Organization:
none
>Environment:
n/a
================
>Description:

The date(1) man page doesn't say which of the CMOS/motherboard and
CPU/OS clocks the program sets (it sets both), which is less than
helpful to those used to other operating systems (eg, Linux) where
the clocks may be set separately (which is considered a feature, not a
bug, by many who've thought about it much).  Despite what some long-
time Unix SA my think, it's not obvious that "date" should change
the CMOS/motherboard clock too.

Of less importance, it also doesn't say which of the two clocks it
is reporting on when it displays "the time".  Few will guess wrong,
but man pages should not assume good guessing.
================
>How-To-Repeat:
n/a
================
>Fix:

Explain that "date" sets both the CMOS/motherboard and the CPU/OS
clocks.  Explain that it only reports on the CPU/OS clock.
>Release-Note:
>Audit-Trail:

From: Mike DeGraw-Bertsch <mbertsch@radioactivedata.org>
To: freebsd-gnats-submit@FreeBSD.org, swear@blarg.net
Cc:  
Subject: Re: docs/35606: date(1) page doesn't say which clock(s) it sets.
Date: Thu, 04 Apr 2002 05:03:43 -0500

 Howdy,
 
 This patch adds "The date utility displays the date and time read from 
 the kernel clock.  When used to set the date and time, both the kernel 
 clock and the CMOS clock are updated." as the second paragraph in the 
 DESCRIPTION section.
 
    -Mike
 
 
 --- date.1.old  Thu Apr  4 04:43:58 2002
 +++ date.1      Thu Apr  4 05:02:51 2002
 @@ -72,6 +72,12 @@
   .Nm
   will set the date and time or print it in a user-defined way.
   .Pp
 +The
 +.Nm
 +utility displays the date and time read from the kernel clock.
 +When used to set the date and time,
 +both the kernel clock and the CMOS clock are updated.
 +.Pp
   Only the superuser may set the date,
   and if the system securelevel (see
   .Xr securelevel 8 )
 

From: swear@blarg.net (Gary W. Swearingen)
To: Mike DeGraw-Bertsch <mbertsch@radioactivedata.org>
Cc: freebsd-gnats-submit@FreeBSD.org
Subject: Re: docs/35606: date(1) page doesn't say which clock(s) it sets.
Date: 04 Apr 2002 11:32:50 -0800

 That's good.
Responsible-Changed-From-To: freebsd-doc->trhodes 
Responsible-Changed-By: trhodes 
Responsible-Changed-When: Sun Apr 14 22:52:12 PDT 2002 
Responsible-Changed-Why:  
I'll take this one. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=35606 
State-Changed-From-To: open->patched 
State-Changed-By: trhodes 
State-Changed-When: Mon Apr 15 11:20:18 PDT 2002 
State-Changed-Why:  
The supplied patch does not apply, I rebuilt it and applied to CURRENT, I 
will apply this to STABLE in a day.  Thanks! 

http://www.freebsd.org/cgi/query-pr.cgi?pr=35606 
State-Changed-From-To: patched->closed 
State-Changed-By: trhodes 
State-Changed-When: Wed Apr 17 07:52:22 PDT 2002 
State-Changed-Why:  
A slightly different version of the patch committed to CURRENT and STABLE, 
mainly just s/CMOS/hardware/ as requested by bde 

http://www.freebsd.org/cgi/query-pr.cgi?pr=35606 
>Unformatted:
