This is the latest version of a program to enable displaying the battery save
mode and power-up mode in a popup window under X11 when they are changed using
the Fn+F2 and Fn+F3 key combinations on a Toshiba laptop. It should be noted
that the program does *not* change the settings, but provides the facility to
view the settings whilst changing them.

While I have only been able to test it on my Satellite Pro 400CS, reports from
users on the Internet indicates the program works on the following Toshiba
laptops,

 o Satellite Pro 400x, 410x, 420x, 430x, 440x, 460x, 470x, 480X
 o Satellite     100x, 110x, 200x, 210x, 220x, 230x, 300x, 310x, 320x
 o Portage       300x, 610x, 660x
 o Tecra         500x, 510x, 520x, 530x, 710x, 720x, 730x, 740x
 o Other Models  T3400x

It does *not* work on Libretto's and reports indicate that it does not work on
the Tecra 750x. I am keen to hear reports of success/failure for any Toshiba
laptop *not* listed above. I am also soliciting translations of the strings in
hotkey.h into other languages.

Hotkey is still work in progress. In particular it's inital release was neither
optimized for processor usage, or had all the features I wanted. The current
version fixes many of these problems. It has had a few obscure bugs removed,
uses far less processor time, has a fallback monochrome mode and supports
multibyte languages. Still missing is a console mode to the program. This will
popup a small window on the console screens as well as the local X11 display.
It will also be configurable at compile time for console mode only, for those
who never run X11.

Installation should be a dodle type 'make hotkey' to build the program,
provided you are logged in as root you can then test it out. You can install
the program with 'make install' provided you are logged in as root, as it
requires the setuid bit to be set in order to get the necessary permissions on
the I/O ports. As far as I am aware the program should not present any security
holes and drops root priveledges as soon as it get access to the I/O ports, but
I am not an expert. One final note, it must be compiled with optimizations
turned on, or the inline assembler for doing I/O won't work.

JAB.

-----------------------------------------------------------------------
Jonathan A. Buzzard                 Email: jab@hex.prestel.co.uk
Northumberland, United Kingdom.       Tel: +44(0)1661-832195
