From owner-freebsd-doc@FreeBSD.ORG Wed Mar 7 23:10:13 2012 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 3AED81065672 for ; Wed, 7 Mar 2012 23:10:13 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id 17C5F8FC17 for ; Wed, 7 Mar 2012 23:10:13 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.5/8.14.5) with ESMTP id q27NAC1H020817 for ; Wed, 7 Mar 2012 23:10:12 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.5/8.14.5/Submit) id q27NAC3B020816; Wed, 7 Mar 2012 23:10:12 GMT (envelope-from gnats) Resent-Date: Wed, 7 Mar 2012 23:10:12 GMT Resent-Message-Id: <201203072310.q27NAC3B020816@freefall.freebsd.org> Resent-From: FreeBSD-gnats-submit@FreeBSD.org (GNATS Filer) Resent-To: freebsd-doc@FreeBSD.org Resent-Reply-To: FreeBSD-gnats-submit@FreeBSD.org, Robert Simmons Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 27DEE106566C for ; Wed, 7 Mar 2012 23:02:55 +0000 (UTC) (envelope-from nobody@FreeBSD.org) Received: from red.freebsd.org (red.freebsd.org [IPv6:2001:4f8:fff6::22]) by mx1.freebsd.org (Postfix) with ESMTP id 003A28FC18 for ; Wed, 7 Mar 2012 23:02:55 +0000 (UTC) Received: from red.freebsd.org (localhost [127.0.0.1]) by red.freebsd.org (8.14.4/8.14.4) with ESMTP id q27N2sjp054299 for ; Wed, 7 Mar 2012 23:02:54 GMT (envelope-from nobody@red.freebsd.org) Received: (from nobody@localhost) by red.freebsd.org (8.14.4/8.14.4/Submit) id q27N2s9i054298; Wed, 7 Mar 2012 23:02:54 GMT (envelope-from nobody) Message-Id: <201203072302.q27N2s9i054298@red.freebsd.org> Date: Wed, 7 Mar 2012 23:02:54 GMT From: Robert Simmons To: freebsd-gnats-submit@FreeBSD.org X-Send-Pr-Version: www-3.1 Cc: Subject: docs/165841: Grammar improvement and text clarification for adjkerntz(8) man page X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 07 Mar 2012 23:10:13 -0000 >Number: 165841 >Category: docs >Synopsis: Grammar improvement and text clarification for adjkerntz(8) man page >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 07 23:10:12 UTC 2012 >Closed-Date: >Last-Modified: >Originator: Robert Simmons >Release: HEAD >Organization: >Environment: >Description: My next step in proofreading man pages (more to come). I've made a couple of parts of the man page read a bit clearer and I've cleaned up a few grammar and punctuation mistakes. >How-To-Repeat: >Fix: I've attached a patch in unified diff format that fixes the problems. Patch attached with submission follows: --- src/sbin/adjkerntz/adjkerntz.8 2005-02-13 17:25:15.000000000 -0500 +++ src/sbin/adjkerntz/adjkerntz.8.new 2012-03-07 17:56:50.000000000 -0500 @@ -29,7 +29,8 @@ .Os .Sh NAME .Nm adjkerntz -.Nd "adjust local time CMOS clock to reflect time zone changes and keep current timezone offset for the kernel" +.Nd "adjust the local time CMOS clock to reflect time zone changes and keep the current timezone +offset for the kernel" .Sh SYNOPSIS .Nm .Fl i @@ -38,24 +39,22 @@ .Sh DESCRIPTION The .Nm -utility maintains the proper relationship between the kernel clock, which -is always set to UTC, and the CMOS clock, which may be set to local -time. +utility maintains the proper relationship between the kernel clock, which is +always set to UTC and the CMOS clock, which may be set to local time. The .Nm -utility also informs the kernel about machine timezone shifts to +utility also informs the kernel about machine timezone shifts in order to maintain proper timestamps for local time file systems such as the MS-DOS file system. -The main purpose of this thing is not general fixing of -initially broken MS-DOS file timestamp idea but keeping -the same timestamps between +The main purpose of maintaining these timestamps properly is to keep the +timestamps of a .Fx -MS-DOS file system -and MS-DOS operating system installed on the same -machine. +MS-DOS file system and an MS-DOS operating system synchronized when they are +installed on the same system rather than generally fixing broken MS-DOS file +timestamps. If the file .Pa /etc/wall_cmos_clock -exists, it means that CMOS clock keeps local time (MS-DOS and MS-Windows +exists, it means that the CMOS clock keeps local time (MS-DOS and MS-Windows compatible mode). If that file does not exist, it means that the CMOS clock keeps UTC time. The @@ -64,8 +63,8 @@ .Pa machdep.wall_cmos_clock kernel variable. .Pp -Adjustments may be needed at system startup and shutdown, and -whenever a time zone change occurs. +Adjustments may be needed at system startup and shutdown, and whenever a time +zone change occurs. To handle these different situations, .Nm is invoked in two ways: @@ -82,11 +81,11 @@ utility puts itself into the background. Then, for a local time CMOS clock, .Nm -reads the local time from it -and sets the kernel clock to the corresponding UTC time. +reads the local time from it and sets the kernel clock to the +corresponding UTC time. The .Nm -utility also stores the local time zone offset into the +utility also stores the local time zone offset in the .Pa machdep.adjkerntz kernel variable, for use by subsequent invocations of .Em "'adjkerntz -a'" @@ -94,8 +93,8 @@ .Pp For a local time CMOS clock .Em "'adjkerntz -i'" -pauses, and remains inactive as a background daemon until it -receives a SIGTERM. +pauses and remains inactive as a background daemon until it receives a +SIGTERM. The SIGTERM will normally be sent by .Xr init 8 when the system leaves multi-user mode (usually, because the system @@ -120,7 +119,7 @@ calculate a new time zone offset. It stores the new offset into the .Pa machdep.adjkerntz -kernel variable, and updates the wall CMOS clock to the new local time. +kernel variable and updates the wall CMOS clock to the new local time. If .Em "'adjkerntz -a'" was started at a nonexistent time (during a timezone change), it exits >Release-Note: >Audit-Trail: >Unformatted: