docs/62974: [patch] ACPI documentation clear up

[Christian S.J. Peron]

>Number:         62974
>Category:       docs
>Synopsis:       [patch] ACPI documentation clear up
>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:   Tue Feb 17 11:30:21 PST 2004
>Closed-Date:
>Last-Modified:
>Originator:     Christian S.J. Peron
>Release:        FreeBSD 5.2-CURRENT i386
>Organization:
>Environment:
System: FreeBSD movl 5.2-CURRENT FreeBSD 5.2-CURRENT #8: Mon Feb 2 22:04:49 GMT 2004 modulus at movl:/usr/src/sys/i386/compile/ROUTER i386


	
>Description:

	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.


	
>How-To-Repeat:
	N/A
	
>Fix:

--- share/man/man4/acpi.4.bak	Tue Feb 17 19:00:45 2004
+++ share/man/man4/acpi.4	Tue Feb 17 19:17:43 2004
@@ -211,7 +211,8 @@
 .Nm
 driver completely, set the kernel environment variable
 .Va hint.acpi.0.disabled
-to 1.
+to 1 in the device resource hints file
+.Pa /boot/device.hints .
 Some i386 machines totally fail to operate with some or all of ACPI disabled.
 Other i386 machines fail with ACPI enabled.
 Non-i386 platforms do not support operating systems which do not use ACPI.
@@ -363,7 +364,9 @@
 .Sh COMPATIBILITY
 ACPI is only found and supported on i386/ia32, ia64, and amd64.
 .Sh SEE ALSO
+.Xr kenv 1 ,
 .Xr acpi_thermal 4 ,
+.Xr device.hints 5 ,
 .Xr loader.conf 5 ,
 .Xr acpiconf 8 ,
 .Xr acpidump 8 ,
>Release-Note:
>Audit-Trail:
>Unformatted: