From owner-freebsd-doc  Mon Sep 30  9:20: 7 2002
Delivered-To: freebsd-doc@hub.freebsd.org
Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP id 26A7E37B401
	for <freebsd-doc@hub.freebsd.org>; Mon, 30 Sep 2002 09:20:05 -0700 (PDT)
Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21])
	by mx1.FreeBSD.org (Postfix) with ESMTP id 224F043E75
	for <freebsd-doc@hub.freebsd.org>; Mon, 30 Sep 2002 09:20:03 -0700 (PDT)
	(envelope-from gnats@FreeBSD.org)
Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1])
	by freefall.freebsd.org (8.12.6/8.12.6) with ESMTP id g8UGK2Co005205
	for <freebsd-doc@freefall.freebsd.org>; Mon, 30 Sep 2002 09:20:02 -0700 (PDT)
	(envelope-from gnats@freefall.freebsd.org)
Received: (from gnats@localhost)
	by freefall.freebsd.org (8.12.6/8.12.6/Submit) id g8UGK27K005204;
	Mon, 30 Sep 2002 09:20:02 -0700 (PDT)
Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP id D97E737B401
	for <FreeBSD-gnats-submit@freebsd.org>; Mon, 30 Sep 2002 09:15:35 -0700 (PDT)
Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21])
	by mx1.FreeBSD.org (Postfix) with ESMTP id 9A58A43E3B
	for <FreeBSD-gnats-submit@freebsd.org>; Mon, 30 Sep 2002 09:15:35 -0700 (PDT)
	(envelope-from murray@FreeBSD.org)
Received: from freefall.freebsd.org (murray@localhost [127.0.0.1])
	by freefall.freebsd.org (8.12.6/8.12.6) with ESMTP id g8UGFZCo004884
	for <FreeBSD-gnats-submit@freebsd.org>; Mon, 30 Sep 2002 09:15:35 -0700 (PDT)
	(envelope-from murray@freefall.freebsd.org)
Received: (from murray@localhost)
	by freefall.freebsd.org (8.12.6/8.12.6/Submit) id g8UGFZ4H004880;
	Mon, 30 Sep 2002 09:15:35 -0700 (PDT)
Message-Id: <200209301615.g8UGFZ4H004880@freefall.freebsd.org>
Date: Mon, 30 Sep 2002 09:15:35 -0700 (PDT)
From: murray@FreeBSD.org
Reply-To: murray@FreeBSD.org
To: FreeBSD-gnats-submit@FreeBSD.org
X-Send-Pr-Version: 3.113
Subject: docs/43528: ACPI is not documented in the Handbook.
Sender: owner-freebsd-doc@FreeBSD.ORG
Precedence: bulk
List-ID: <freebsd-doc.FreeBSD.ORG>
List-Archive: <http://docs.freebsd.org/mail/> (Web Archive)
List-Help: <mailto:majordomo@FreeBSD.ORG?subject=help> (List Instructions)
List-Subscribe: <mailto:majordomo@FreeBSD.ORG?subject=subscribe%20freebsd-doc>
List-Unsubscribe: <mailto:majordomo@FreeBSD.ORG?subject=unsubscribe%20freebsd-doc>
X-Loop: FreeBSD.org


>Number:         43528
>Category:       docs
>Synopsis:       ACPI is not documented in the Handbook.
>Confidential:   no
>Severity:       serious
>Priority:       high
>Responsible:    freebsd-doc
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Mon Sep 30 09:20:01 PDT 2002
>Closed-Date:
>Last-Modified:
>Originator:     
>Release:        FreeBSD 4.7-RC i386
>Organization:
FreeBSD Mall, Inc.
>Environment:
System: FreeBSD builder.freebsdmall.com 4.7-RC FreeBSD 4.7-RC #17: Sun Sep 29 15:18:19 PDT 2002 murray@builder.freebsdmall.com:/usr/obj/usr/src/sys/BUILDER i386

>Description:

ACPI is not documented at all in the Handbook.  It does not show up in
the INDEX.  Multiple pages of user documentation need to be written
for the Handbook to show users how to accomplish basic tasks with
ACPI.

How do you suspend a laptop with ACPI?  What different suspend options
are available?  What is the difference between them?

How do you use CPU throttling?

What do common ACPI error messages mean?

This is a important new feature for FreeBSD 5.0, and we must document
it before November.

The terse information in the man pages is not good enough by a long
shot.  We need more user-oriented documentation on these features.

>How-To-Repeat:

>Fix:

Add a new section for the handbook that covers ACPI.


>Release-Note:
>Audit-Trail:
>Unformatted:

To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message