kern/39932: asus(4) man page and acpi(4) man page improvements

[leonardo1990%gmail.com@localhost]

>Number:         39932
>Category:       kern
>Synopsis:       asus(4) is not documented
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    kern-bug-people
>State:          open
>Class:          doc-bug
>Submitter-Id:   net
>Arrival-Date:   Sun Nov 16 01:25:00 +0000 2008
>Originator:     Leonardo Taccari
>Release:        NetBSD 4.0.1
>Organization:
NetBSD Italia
>Environment:
        
        
System: NetBSD bianconiglio 4.0.1 NetBSD 4.0.1 (BIANCONIGLIO) #0: Sat Oct 18 
15:44:19 CEST 2008 
leot@bianconiglio:/home/leot/builds/usr/src/sys/arch/i386/compile/BIANCONIGLIO 
i386
Architecture: i386
Machine: i386
>Description:
        The asus(4) device driver is not documented and various acpi(4) (recent)
        device drivers are not added to acpi(4) man page.
>How-To-Repeat:
        For the former:
        $ man 4 asus

        For the latter:
        $ man 4 acpi
        /acpidalb
        /asus
        /thinkpad
>Fix:
        Please review and import the asus(4) man page and acpi(4) patch attached
        on this PR. Thank you very much!

        A note: I tested the asus(4) with my Eee PC 900 with NetBSD 5.0_BETA but
        AFAIK the asus(4) hotkeys are the same for every laptops/netbooks.


.\" $NetBSD$
.\"
.\" Copyright (c) 2008 The NetBSD Foundation, Inc.
.\" All rights reserved.
.\"
.\" Redistribution and use in source and binary forms, with or without
.\" modification, are permitted provided that the following conditions
.\" are met:
.\" 1. Redistributions of source code must retain the above copyright
.\"    notice, this list of conditions and the following disclaimer.
.\" 2. Redistributions in binary form must reproduce the above copyright
.\"    notice, this list of conditions and the following disclaimer in the
.\"    documentation and/or other materials provided with the distribution.
.\"
.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
.\" PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
.\" POSSIBILITY OF SUCH DAMAGE.
.\"
.Dd November 15, 2008
.Dt ASUS 4
.Os
.Sh NAME
.Nm asus
.Nd ASUS hotkeys
.Sh SYNOPSIS
.Cd "asus*  at acpi?"
.Sh DESCRIPTION
The
.Nm
driver provides support for hotkeys available in various ASUS laptops and
netbooks (Eee PC series included).
.Pp
The following hotkeys are directly handled by
.Nm :
.Bl -tag -width pcdisplay -offset indent
.It \&Fn + F3
Decrease LCD brightness
.It \&Fn + F4
Increase LCD brightness
.It \&Fn + F5
Switch between LCD and external video output
.It \&Fn + F7
Toggle audio
.It \&Fn + F8
Volume down
.It \&Fn + F9
Volume up
.Sh SEE ALSO
.Xr acpi 4 ,
.Xr powerd 8
.Sh HISTORY
The
.Nm
driver appeared in
.Nx 5.0 .
.Sh AUTHORS
.An -nosplit
The
.Nm
device driver was written by
.An "Jared D. McNeill" .
This man page was written by
.An "Leonardo Taccari" .
.Sh BUGS
At the moment
.Nm
does not handle
Fn + F6 (Task manager)


Index: acpi.4
===================================================================
RCS file: /cvsroot/src/share/man/man4/acpi.4,v
retrieving revision 1.29
diff -u -p -r1.29 acpi.4
--- acpi.4      21 Sep 2008 11:12:36 -0000      1.29
+++ acpi.4      16 Nov 2008 01:03:46 -0000
@@ -24,7 +24,7 @@
 .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
 .\" POSSIBILITY OF SUCH DAMAGE.
 .\"
-.Dd September 21, 2008
+.Dd November 15, 2008
 .Dt ACPI 4
 .Os
 .Sh NAME
@@ -35,11 +35,13 @@
 .Cd "acpiacad* at acpi?"
 .Cd "acpibat*  at acpi?"
 .Cd "acpibut*  at acpi?"
+.Cd "acpidalb* at acpi?"
 .Cd "acpiec*   at acpi?"
 .Cd "acpilid*  at acpi?"
 .Cd "acpitz*   at acpi?"
-.Cd "attimer*  at acpi?"
 .Cd "aiboost*  at acpi?"
+.Cd "asus*     at acpi?"
+.Cd "attimer*  at acpi?"
 .Cd "com*      at acpi?"
 .Cd "fdc*      at acpi?"
 .Cd "hpet*     at acpi?"
@@ -51,6 +53,7 @@
 .Cd "pcppi*    at acpi?"
 .Cd "sony*     at acpi?"
 .Cd "spic*     at acpi?"
+.Cd "thinkpad* at acpi?"
 .Cd "ug*       at acpi?"
 .Cd "vald*     at acpi?"
 .Cd "wss*      at acpi?"
@@ -148,6 +151,9 @@ Control Method Batteries.
 .It acpibut
 .Tn ACPI
 power and sleep buttons.
+.It acpidalb
+.Tn ACPI
+Direct Application Launch Buttons.
 .It acpiec
 .Tn ACPI
 Embedded Controllers.
@@ -157,10 +163,12 @@ lid switches.
 .It acpitz
 .Tn ACPI
 thermal zones.
-.It attimer
-AT Timer.
 .It aiboost
 ASUS AI Booster Hardware monitor.
+.It asus
+ASUS hotkeys.
+.It attimer
+AT Timer.
 .It com
 NS8250-, NS16450-, and NS16550-based serial ports.
 .It fdc
@@ -175,6 +183,8 @@ Standard ISA parallel port interface.
 Roland MPU-401 (compatible) MIDI UART.
 .It pcppi
 AT-style speaker sound.
+.It thinkpad
+IBM/Lenovo Thinkpad hotkeys.
 .It ug
 Abit uGuru Hardware monitor.
 .It wss
@@ -199,11 +209,13 @@ Toshiba Libretto device.
 .Xr acpiacad 4 ,
 .Xr acpibat 4 ,
 .Xr acpibut 4 ,
+.Xr acpidalb 4 ,
 .Xr acpiec 4 ,
 .Xr acpilid 4 ,
 .Xr acpitz 4 ,
 .Xr aiboost 4 ,
 .Xr apm 4 ,
+.Xr asus 4 ,
 .Xr attimer 4 ,
 .Xr com 4 ,
 .Xr fdc 4 ,
@@ -216,6 +228,7 @@ Toshiba Libretto device.
 .Xr pcppi 4 ,
 .Xr sony 4 ,
 .Xr spic 4 ,
+.Xr thinkpad 4 ,
 .Xr ug 4 ,
 .Xr vald 4 ,
 .Xr wss 4 ,

>Unformatted: