From owner-freebsd-doc@freebsd.org  Fri Feb  3 13:09:10 2017
Return-Path: <owner-freebsd-doc@freebsd.org>
Delivered-To: freebsd-doc@mailman.ysv.freebsd.org
Received: from mx1.freebsd.org (mx1.freebsd.org
 [IPv6:2001:1900:2254:206a::19:1])
 by mailman.ysv.freebsd.org (Postfix) with ESMTP id E3D56CCDEDC
 for <freebsd-doc@mailman.ysv.freebsd.org>;
 Fri,  3 Feb 2017 13:09:10 +0000 (UTC)
 (envelope-from bugzilla-noreply@freebsd.org)
Received: from kenobi.freebsd.org (kenobi.freebsd.org
 [IPv6:2001:1900:2254:206a::16:76])
 (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits))
 (Client did not present a certificate)
 by mx1.freebsd.org (Postfix) with ESMTPS id D3FB8FFA
 for <freebsd-doc@FreeBSD.org>; Fri,  3 Feb 2017 13:09:10 +0000 (UTC)
 (envelope-from bugzilla-noreply@freebsd.org)
Received: from bugs.freebsd.org ([127.0.1.118])
 by kenobi.freebsd.org (8.15.2/8.15.2) with ESMTP id v13D9AXV004805
 for <freebsd-doc@FreeBSD.org>; Fri, 3 Feb 2017 13:09:10 GMT
 (envelope-from bugzilla-noreply@freebsd.org)
From: bugzilla-noreply@freebsd.org
To: freebsd-doc@FreeBSD.org
Subject: [Bug 216753] ACPI documentation needs cleaning up
Date: Fri, 03 Feb 2017 13:09:10 +0000
X-Bugzilla-Reason: AssignedTo
X-Bugzilla-Type: new
X-Bugzilla-Watch-Reason: None
X-Bugzilla-Product: Documentation
X-Bugzilla-Component: Documentation
X-Bugzilla-Version: Latest
X-Bugzilla-Keywords: 
X-Bugzilla-Severity: Affects Only Me
X-Bugzilla-Who: avg@FreeBSD.org
X-Bugzilla-Status: New
X-Bugzilla-Resolution: 
X-Bugzilla-Priority: ---
X-Bugzilla-Assigned-To: freebsd-doc@FreeBSD.org
X-Bugzilla-Flags: 
X-Bugzilla-Changed-Fields: bug_id short_desc product version rep_platform
 op_sys bug_status bug_severity priority component assigned_to reporter
Message-ID: <bug-216753-9@https.bugs.freebsd.org/bugzilla/>
Content-Type: text/plain; charset="UTF-8"
Content-Transfer-Encoding: quoted-printable
X-Bugzilla-URL: https://bugs.freebsd.org/bugzilla/
Auto-Submitted: auto-generated
MIME-Version: 1.0
X-BeenThere: freebsd-doc@freebsd.org
X-Mailman-Version: 2.1.23
Precedence: list
List-Id: Documentation project <freebsd-doc.freebsd.org>
List-Unsubscribe: <https://lists.freebsd.org/mailman/options/freebsd-doc>,
 <mailto:freebsd-doc-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/freebsd-doc/>
List-Post: <mailto:freebsd-doc@freebsd.org>
List-Help: <mailto:freebsd-doc-request@freebsd.org?subject=help>
List-Subscribe: <https://lists.freebsd.org/mailman/listinfo/freebsd-doc>,
 <mailto:freebsd-doc-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Fri, 03 Feb 2017 13:09:11 -0000

https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=3D216753

            Bug ID: 216753
           Summary: ACPI documentation needs cleaning up
           Product: Documentation
           Version: Latest
          Hardware: Any
                OS: Any
            Status: New
          Severity: Affects Only Me
          Priority: ---
         Component: Documentation
          Assignee: freebsd-doc@FreeBSD.org
          Reporter: avg@FreeBSD.org

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 remove=
d.
We should change the language that describes ACPI as something new and bugg=
y 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.

--=20
You are receiving this mail because:
You are the assignee for the bug.=