From murray@FreeBSD.org  Mon Sep 30 09:15:35 2002
Return-Path: <murray@FreeBSD.org>
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
Cc:
Subject: ACPI is not documented in the Handbook.
X-Send-Pr-Version: 3.113
X-GNATS-Notify:

>Number:         43528
>Category:       docs
>Synopsis:       ACPI is not documented in the Handbook.
>Confidential:   no
>Severity:       serious
>Priority:       high
>Responsible:    trhodes
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Mon Sep 30 09:20:01 PDT 2002
>Closed-Date:    Sat Jan 04 10:27:04 PST 2003
>Last-Modified:  Sat Jan 04 10:27:04 PST 2003
>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:

From: John Baldwin <jhb@FreeBSD.org>
To: murray@FreeBSD.org
Cc: FreeBSD-gnats-submit@FreeBSD.org
Subject: RE: docs/43528: ACPI is not documented in the Handbook.
Date: Mon, 30 Sep 2002 13:09:23 -0400 (EDT)

 On 30-Sep-2002 murray@FreeBSD.org wrote:
 > 
 >>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?
 
 The same exact way you do with apm.  I.e. close the lid, hit the suspend
 key, etc.  Is this even documented for apm(8)?
 
 > How do you use CPU throttling?
 
 You don't for the most part, that is behind the scenes.
 
 > What do common ACPI error messages mean?
 
 I don't even know what most of those are. :(
 
 Almost everything ACPI gives you is transparent.  The same interface that
 apm used is supported, so battery status applets that work with APM will
 work with ACPI.  The only difference is new features may work such as
 hitting the suspend key on the keyboard actually working and hitting the
 power button actually doing a clean power down and soft off.
 
 -- 
 
 John Baldwin <jhb@FreeBSD.org>  <><  http://www.FreeBSD.org/~jhb/
 "Power Users Use the Power to Serve!"  -  http://www.FreeBSD.org/
Responsible-Changed-From-To: freebsd-doc->trhodes 
Responsible-Changed-By: trhodes 
Responsible-Changed-When: Tue Nov 5 17:20:49 PST 2002 
Responsible-Changed-Why:  
Task List. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=43528 

From: Hiten Pandya <hiten@unixdaemons.com>
To: bug-followup@FreeBSD.org
Cc:  
Subject: Re: docs/43528: ACPI is not documented in the Handbook.
Date: Fri, 08 Nov 2002 18:18:43 +0000

 --- Tom Rhodes <trhodes@FreeBSD.org> wrote:
   > Synopsis: ACPI is not documented in the Handbook.
   >
   > Responsible-Changed-From-To: freebsd-doc->trhodes
   > Responsible-Changed-By: trhodes
   > Responsible-Changed-When: Tue Nov 5 17:20:49 PST 2002
   > Responsible-Changed-Why:
   > Task List.
   >
   > http://www.freebsd.org/cgi/query-pr.cgi?pr=43528
 
 Hi there.
 
 I had started some work on the documentation of ACPI, but I am currently
 not doing any work on it, well, not atleast for another week or two because
 of mock examinations.  However, I have some introductory stuff written, you
 can find it at:
 
     http://www.unixdaemons.com/~hiten/work/acpi
 
 Let me know if its useful to you.  There is a chance I will be doing some
 work on it over this weekend.  I have some other stuff written up too, on
 the ACPI sysctls and stuff, but not yet formatted.
 
 Cheers.
 
 -- 
 Hiten
 hiten@unixdaemons.com, hiten@uk.FreeBSD.org, hiten@softweyr.com
 
 
State-Changed-From-To: open->closed 
State-Changed-By: trhodes 
State-Changed-When: Sat Jan 4 10:26:41 PST 2003 
State-Changed-Why:  
Closed.  I've added a nice chunk of information. 

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