[src/trunk]: src/usr.sbin/apm Add a note that APM was deprecated by the PC ma...

[jruoho <jruoho%NetBSD.org@localhost>]

details:   https://anonhg.NetBSD.org/src/rev/0b9a57ce29a6
branches:  trunk
changeset: 753201:0b9a57ce29a6
user:      jruoho <jruoho%NetBSD.org@localhost>
date:      Sat Mar 20 07:59:44 2010 +0000

description:
Add a note that APM was deprecated by the PC manufacturers in about 1996.
Mention the APM emulation layer of ACPI. In addition, some small fixes.

diffstat:

 usr.sbin/apm/apm.8 |  54 +++++++++++++++++++++++++++++++++++++++++-------------
 1 files changed, 41 insertions(+), 13 deletions(-)

diffs (104 lines):

diff -r e3850cdcacb5 -r 0b9a57ce29a6 usr.sbin/apm/apm.8
--- a/usr.sbin/apm/apm.8        Sat Mar 20 02:53:35 2010 +0000
+++ b/usr.sbin/apm/apm.8        Sat Mar 20 07:59:44 2010 +0000
@@ -1,6 +1,6 @@
-.\"    $NetBSD: apm.8,v 1.19 2008/09/25 22:44:51 reed Exp $
+.\"    $NetBSD: apm.8,v 1.20 2010/03/20 07:59:44 jruoho Exp $
 .\"
-.\" Copyright (c) 1996 The NetBSD Foundation, Inc.
+.\" Copyright (c) 1996, 2010 The NetBSD Foundation, Inc.
 .\" All rights reserved.
 .\"
 .\" This code is derived from software contributed to The NetBSD Foundation
@@ -27,7 +27,7 @@
 .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
 .\" POSSIBILITY OF SUCH DAMAGE.
 .\"
-.Dd June 18, 1996
+.Dd March 20, 2010
 .Dt APM 8
 .Os
 .Sh NAME
@@ -46,11 +46,14 @@
 .Op Fl f Ar sockname
 .Ek
 .Sh DESCRIPTION
+The
 .Nm
-communicates with the Advanced Power Management daemon,
+program communicates with the Advanced Power Management
+.Pq Tn APM
+daemon,
 .Xr apmd 8 ,
-making requests of it for current power status or to place the system
-into a suspend or stand-by state.
+making requests of the current power status or placing the system either
+into suspend or stand-by state.
 The
 .Nm
 tool is only installed on supported platforms.
@@ -60,7 +63,7 @@
 displays the current power management state in verbose form.
 .Pp
 Available command-line flags are:
-.Bl -tag -width indent -compact
+.Bl -tag -width "-f sockname" -compact
 .It Fl z
 Put the system into suspend (deep sleep) mode.
 .It Fl S
@@ -70,10 +73,11 @@
 .It Fl m
 Display the estimated battery lifetime in minutes.
 .It Fl b
-Display the battery status.  0 means high, 1 means low, 2 means
-critical, 3 means charging, 4 means absent, and 255 means unknown.
+Display the battery status:
+0 means high, 1 means low, 2 means critical, 3 means charging,
+4 means absent, and 255 means unknown.
 .It Fl a
-Display the external charger (A/C status).  0 means disconnected, 1
+Display the external charger (A/C status):  0 means disconnected, 1
 means connected, 2 means backup power source, and 255 means unknown.
 .It Fl s
 Display if power management is enabled.
@@ -122,13 +126,37 @@
 is the status device used when the socket is not accessible; it must be
 readable to provide current APM status.
 .Sh SEE ALSO
+.Xr acpi 4 ,
 .Xr apm 4 ,
 .Xr apmd 8
-.Sh REFERENCES
-Advanced Power Management (APM) BIOS Interface Specification (revision
-1.1), Intel Corporation and Microsoft Corporation
+.Rs
+.%A Intel Corporation
+.%A Microsoft Corporation
+.%T Advanced Power Management (APM) BIOS Interface Specification
+.%N Revision 1.2
+.%D February 1996
+.Re
 .Sh HISTORY
 The
 .Nm
 command appeared in
 .Nx 1.3 .
+.Pp
+The
+.Tn APM
+specification first appeared in 1992.
+The last update to the standard was made in 1996 -
+the same year when it was superceded by the
+.Tn ACPI 1.0
+standard.
+Thereafter power management on IBM-compatible personal computers has relied on
+.Tn ACPI ,
+implemented in
+.Nx
+by the
+.Xr acpi 4
+subsystem.
+The
+.Xr acpi 4
+provides an emulation layer for the legacy
+.Nm .