[src/trunk]: src/share/man/man4 Reference aps(4) and thinkpad(4) with each ot...

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

details:   https://anonhg.NetBSD.org/src/rev/838ab6f5b857
branches:  trunk
changeset: 755561:838ab6f5b857
user:      jruoho <jruoho%NetBSD.org@localhost>
date:      Wed Jun 09 13:44:24 2010 +0000

description:
Reference aps(4) and thinkpad(4) with each other.

In aps(4) note that sensor values are refreshed every 0.5 seconds, which may
have a negative effect on battery life.

(Since the sensors are purely descriptive and no time-sensitive protective
measures are being carried out, it would probably be a good idea to remove
the whole callout(9) from the driver and let the sysmon's poll cycle take
over.)

diffstat:

 share/man/man4/aps.4      |  21 ++++++++++++++++-----
 share/man/man4/thinkpad.4 |   5 +++--
 2 files changed, 19 insertions(+), 7 deletions(-)

diffs (80 lines):

diff -r d22675c65685 -r 838ab6f5b857 share/man/man4/aps.4
--- a/share/man/man4/aps.4      Wed Jun 09 13:44:22 2010 +0000
+++ b/share/man/man4/aps.4      Wed Jun 09 13:44:24 2010 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: aps.4,v 1.2 2007/09/11 22:27:04 wiz Exp $
+.\"    $NetBSD: aps.4,v 1.3 2010/06/09 13:44:24 jruoho Exp $
 .\"    $OpenBSD: aps.4,v 1.7 2007/05/31 19:19:49 jmc Exp $
 .\"
 .\" Copyright (c) 2005 Jonathan Gray <jsg%openbsd.org@localhost>
@@ -15,7 +15,7 @@
 .\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
 .\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
 .\"
-.Dd September 11, 2007
+.Dd June 9, 2010
 .Dt APS 4
 .Os
 .Sh NAME
@@ -45,6 +45,7 @@
 .El
 .Sh SEE ALSO
 .Xr envsys 4 ,
+.Xr thinkpad 4 ,
 .Xr envstat 8
 .Sh HISTORY
 The
@@ -60,14 +61,24 @@
 driver was written by
 .An Jonathan Gray Aq jsg%openbsd.org@localhost .
 .Sh CAVEATS
+Few issues can be mentioned.
+.Bl -bullet
+.It
 The
 .Nm
-driver does not yet maintain state and subsequently does not take
+driver does not maintain state and subsequently does not take
 evasive action when it thinks the hard drive is in danger.
-.Pp
+Possible actions would include spinning down the hard drive
+in case excessive tremor is detected by the sensors.
+.It
 The Y axis on X40 and possibly other models seems to be inverted.
 It is unknown how to distinguish between different versions of the
 accelerometer to compensate for this in the driver at this time.
-.Pp
+.It
+The sensor values are refreshed every 0.5 seconds.
+Because no protection measures are taken,
+this is unnecessary and may have a negative effect on battery life.
+.It
 As IBM provides no documentation, it is not known what all the available
 sensors are used for.
+.El
diff -r d22675c65685 -r 838ab6f5b857 share/man/man4/thinkpad.4
--- a/share/man/man4/thinkpad.4 Wed Jun 09 13:44:22 2010 +0000
+++ b/share/man/man4/thinkpad.4 Wed Jun 09 13:44:24 2010 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: thinkpad.4,v 1.1 2008/10/18 20:44:53 jmcneill Exp $
+.\"    $NetBSD: thinkpad.4,v 1.2 2010/06/09 13:44:24 jruoho Exp $
 .\"
 .\" Copyright (c) 2008 Jared D. McNeill <jmcneill%invisible.ca@localhost>
 .\" All rights reserved.
@@ -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 October 18, 2008
+.Dd June 9, 2010
 .Dt THINKPAD 4
 .Os
 .Sh NAME
@@ -40,6 +40,7 @@
 temperature and fan monitoring.
 .Sh SEE ALSO
 .Xr acpi 4 ,
+.Xr aps 4 ,
 .Xr pmf 9 ,
 .Xr sysmon_envsys 9
 .Sh HISTORY