NetBSD Problem Report #39932

From leonardo1990@gmail.com  Sun Nov 16 01:22:25 2008
Return-Path: <leonardo1990@gmail.com>
Received: from mail.netbsd.org (mail.netbsd.org [204.152.190.11])
	by narn.NetBSD.org (Postfix) with ESMTP id E0D8063B966
	for <gnats-bugs@gnats.netbsd.org>; Sun, 16 Nov 2008 01:22:25 +0000 (UTC)
Message-Id: <491f75cf.2283420a.78e5.6622@mx.google.com>
Date: Sat, 15 Nov 2008 17:22:23 -0800 (PST)
From: leonardo1990@gmail.com
Reply-To: leonardo1990@gmail.com
To: gnats-bugs@gnats.NetBSD.org
Subject: asus(4) man page and acpi(4) man page improvements
X-Send-Pr-Version: 3.95

>Number:         39932
>Category:       kern
>Synopsis:       asus(4) is not documented
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    kern-bug-people
>State:          closed
>Class:          doc-bug
>Submitter-Id:   net
>Arrival-Date:   Sun Nov 16 01:25:00 +0000 2008
>Closed-Date:    Sun Jul 13 08:45:11 +0000 2014
>Last-Modified:  Tue Oct 14 15:55:00 +0000 2014
>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 ,

>Release-Note:

>Audit-Trail:
From: "Marc Balmer" <mbalmer@netbsd.org>
To: gnats-bugs@gnats.NetBSD.org
Cc: 
Subject: PR/39932 CVS commit: src
Date: Sun, 13 Jul 2014 08:37:13 +0000

 Module Name:	src
 Committed By:	mbalmer
 Date:		Sun Jul 13 08:37:13 UTC 2014

 Modified Files:
 	src/distrib/sets/lists/man: mi
 	src/share/man/man4: Makefile
 Added Files:
 	src/share/man/man4: asus.4

 Log Message:
 Add a man page for asus(4), written by Leonardo Taccari as part of PR/39932.


 To generate a diff of this commit:
 cvs rdiff -u -r1.1478 -r1.1479 src/distrib/sets/lists/man/mi
 cvs rdiff -u -r1.614 -r1.615 src/share/man/man4/Makefile
 cvs rdiff -u -r0 -r1.1 src/share/man/man4/asus.4

 Please note that diffs are not public domain; they are subject to the
 copyright notices on the relevant files.

State-Changed-From-To: open->closed
State-Changed-By: mbalmer@NetBSD.org
State-Changed-When: Sun, 13 Jul 2014 08:45:11 +0000
State-Changed-Why:
Manual page for asus(4) added and acpi(4) man page checked.
Thanks!


From: Leonardo Taccari <iamleot@gmail.com>
To: gnats-bugs@NetBSD.org
Cc: 
Subject: Re: kern/39932 (asus(4) is not documented)
Date: Sun, 13 Jul 2014 18:44:06 +0200

 Hi Marc,

 On Sun, Jul 13, 2014 at 08:45:11AM +0000, mbalmer@NetBSD.org wrote:
 > Synopsis: asus(4) is not documented
 > 
 > State-Changed-From-To: open->closed
 > State-Changed-By: mbalmer@NetBSD.org
 > State-Changed-When: Sun, 13 Jul 2014 08:45:11 +0000
 > State-Changed-Why:
 > Manual page for asus(4) added and acpi(4) man page checked.
 > Thanks!
 Thank you very much for looking at this after various years!

 I'm not sure if it should wait for feedback especially for the
 DESCRIPTION part... Actually I don't remember why but Jared D. McNeill
 said to me in #netbsd@Freenode that it need improvements in the
 man page but I don't remember exactly what now.

 If a NetBSD developer can confirm that all the information are correct
 and that they apply on recent ASUS laptops too feel free to ignore this
 email.
 I remember that I RTFS at that time in case of doubt and I can confirm
 that the information are correct for my ASUS Eee PC 900 (still running
 NetBSD, but 6.1.4).


 Ciao,
 L.

From: David Holland <dholland-bugs@netbsd.org>
To: gnats-bugs@NetBSD.org, "Jared D. McNeill" <jmcneill@netbsd.org>
Cc: 
Subject: Re: kern/39932 (asus(4) is not documented)
Date: Sun, 13 Jul 2014 16:45:04 +0000

 On Sun, Jul 13, 2014 at 04:40:01PM +0000, Leonardo Taccari wrote:
  >  I'm not sure if it should wait for feedback especially for the
  >  DESCRIPTION part... Actually I don't remember why but Jared D. McNeill
  >  said to me in #netbsd@Freenode that it need improvements in the
  >  man page but I don't remember exactly what now.

 We could ask him ;-)

  >  If a NetBSD developer can confirm that all the information are correct
  >  and that they apply on recent ASUS laptops too feel free to ignore this
  >  email.

 Structually and syntactically and all that it looks fine to me. I'm
 sure you know more than I do about the subject matter and the details.

 -- 
 David A. Holland
 dholland@netbsd.org

From: David Holland <dholland-bugs@netbsd.org>
To: gnats-bugs@netbsd.org
Cc: 
Subject: Re: kern/39932 (asus(4) is not documented)
Date: Tue, 14 Oct 2014 15:52:27 +0000

 On Sun, Jul 13, 2014 at 04:50:00PM +0000, David Holland wrote:
  > From: David Holland <dholland-bugs@netbsd.org>
  > To: gnats-bugs@NetBSD.org, "Jared D. McNeill" <jmcneill@netbsd.org>
  > Cc: 
  > Subject: Re: kern/39932 (asus(4) is not documented)
  > Date: Sun, 13 Jul 2014 16:45:04 +0000
  > 
  >  On Sun, Jul 13, 2014 at 04:40:01PM +0000, Leonardo Taccari wrote:
  >   >  I'm not sure if it should wait for feedback especially for the
  >   >  DESCRIPTION part... Actually I don't remember why but Jared D. McNeill
  >   >  said to me in #netbsd@Freenode that it need improvements in the
  >   >  man page but I don't remember exactly what now.
  >  
  >  We could ask him ;-)

 For the record, I did and he didn't remember what it was about, so
 we're probably best off just letting it go.

 -- 
 David A. Holland
 dholland@netbsd.org

>Unformatted:

Home	PR Database Search