Bug 216753 - ACPI documentation needs cleaning up
Summary: ACPI documentation needs cleaning up
Status: New
Alias: None
Product: Documentation
Classification: Unclassified
Component: Documentation (show other bugs)
Version: Latest
Hardware: Any Any
: --- Affects Only Me
Assignee: freebsd-doc mailing list
URL:
Keywords:
Depends on:
Blocks:
 
Reported: 2017-02-03 13:09 UTC by Andriy Gapon
Modified: 2017-02-03 13:09 UTC (History)
1 user (show)

See Also:


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description Andriy Gapon freebsd_committer 2017-02-03 13:09:10 UTC
Taking for instance this handbook chapter:
https://www.freebsd.org/doc/handbook/acpi-overview.html

I think that nowadays we can safely remove the language about APM as it is not used anymore.
Chapter 11.13.1 incorrectly states that acpi should not be compiled into the kernel while exactly the opposite is the case for the modern FreeBSD.
Same chapter advises to try to disable acpi as a debugging measure, but the most likely outcome of that is an unbootable system.

Generally, all the mentions of acpi.ko module should be changed to refer to the acpi kernel device.  All advice on disabling acpi and apic should be removed.
We should change the language that describes ACPI as something new and buggy as nowadays ACPI is very well supported and tested.

Some of that medicine should also be applied to https://www.freebsd.org/cgi/man.cgi?acpi as well.