From owner-cvs-all@FreeBSD.ORG  Thu Feb 19 00:44:36 2004
Return-Path: <owner-cvs-all@FreeBSD.ORG>
Delivered-To: cvs-all@freebsd.org
Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP
	id 1CF9516A4CE; Thu, 19 Feb 2004 00:44:36 -0800 (PST)
Received: from smtp.omnis.com (smtp.omnis.com [216.239.128.26])
	by mx1.FreeBSD.org (Postfix) with ESMTP
	id 1200243D1D; Thu, 19 Feb 2004 00:44:36 -0800 (PST)
	(envelope-from wes@softweyr.com)
Received: from zahpod.softweyr.com (66-91-236-204.san.rr.com [66.91.236.204])
	by smtp-relay.omnis.com (Postfix) with ESMTP
	id DE3211880C1A; Thu, 19 Feb 2004 00:44:34 -0800 (PST)
From: Wes Peters <wes@softweyr.com>
Organization: Softweyr
To: Nate Lawson <nate@root.org>
Date: Tue, 17 Feb 2004 21:22:51 -0800
User-Agent: KMail/1.6
References: <20040217203852.724BE16A567@hub.freebsd.org>
	<20040217125043.N30568@root.org>
In-Reply-To: <20040217125043.N30568@root.org>
MIME-Version: 1.0
Content-Disposition: inline
Content-Type: text/plain;
  charset="iso-8859-1"
Content-Transfer-Encoding: 7bit
Message-Id: <200402172122.51326.wes@softweyr.com>
cc: cvs-src@FreeBSD.org
cc: src-committers@FreeBSD.org
cc: Wes Peters <wes@FreeBSD.org>
cc: cvs-all@FreeBSD.org
Subject: Re: cvs commit: src/share/man/man4 acpi.4
X-BeenThere: cvs-all@freebsd.org
X-Mailman-Version: 2.1.1
Precedence: list
List-Id: CVS commit messages for the entire tree <cvs-all.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/cvs-all>,
	<mailto:cvs-all-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/cvs-all>
List-Post: <mailto:cvs-all@freebsd.org>
List-Help: <mailto:cvs-all-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/cvs-all>,
	<mailto:cvs-all-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Thu, 19 Feb 2004 08:44:36 -0000

On Tuesday 17 February 2004 12:52 pm, Nate Lawson wrote:
> On Tue, 17 Feb 2004, Wes Peters wrote:
> > wes         2004/02/17 12:38:49 PST
> >
> >   FreeBSD src repository
> >
> >   Modified files:
> >     share/man/man4       acpi.4
> >   Log:
> >   Make the distinction between sysctl kernel environment variables
> > and device.hints kernel environment variables when disabling ACPI.
> >
> >   Some users are getting confused when they see hint.acpi.0.disabled.
> >   They are confusing it with a sysctl MIB.
> >
> >   Finally, add a reference for device.hints(5) and kenv(1)
> >   in the "SEE ALSO" section of the man page.
> >
> >   PR:             docs/62974
> >   Submitted by:   Christian S.J. Peron <maneo@bsdpro.com>
> >
> >   Revision  Changes    Path
> >   1.27      +4 -1      src/share/man/man4/acpi.4
>
> Please don't recommend they put the hint in device.hints.  That file is
> regenerated as part of the upgrade process.  It should go in
> /boot/loader.conf, which is already cross-referenced by the manpage.

Based on the perverse notion that perhaps everyone in this bikeshed has a 
(partially) valid point, I've rewritten the description a bit.  Please 
contemplate the new verbiage.

-- 

        Where am I, and what am I doing in this handbasket?

Wes Peters                                               wes@softweyr.com