From owner-freebsd-doc Wed Mar 6 15:41: 4 2002 Delivered-To: freebsd-doc@freebsd.org Received: from freefall.freebsd.org (freefall.FreeBSD.org [216.136.204.21]) by hub.freebsd.org (Postfix) with ESMTP id B8F9237B426 for ; Wed, 6 Mar 2002 15:40:01 -0800 (PST) Received: (from gnats@localhost) by freefall.freebsd.org (8.11.6/8.11.6) id g26Ne1H64157; Wed, 6 Mar 2002 15:40:01 -0800 (PST) (envelope-from gnats) Received: from lists.blarg.net (lists.blarg.net [206.124.128.17]) by hub.freebsd.org (Postfix) with ESMTP id 2ABFE37B402 for ; 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 ; 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 ; 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: Date: 06 Mar 2002 15:36:46 -0800 From: "Gary W. Swearingen" Reply-To: swear@blarg.net To: FreeBSD-gnats-submit@freebsd.org Subject: docs/35606: date(1) page doesn't say which clock(s) it sets. Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk List-ID: List-Archive: (Web Archive) List-Help: (List Instructions) List-Subscribe: List-Unsubscribe: X-Loop: FreeBSD.org >Number: 35606 >Category: docs >Synopsis: date(1) page doesn't say which clock(s) it sets. >Confidential: no >Severity: non-critical >Priority: low >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: doc-bug >Submitter-Id: current-users >Arrival-Date: Wed Mar 06 15:40:01 PST 2002 >Closed-Date: >Last-Modified: >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: >Unformatted: To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message