jogdiald for Linux is a simple, customizable popup menu driven by the
jogdial device on Sony VAIO laptops. It requires only X11 (not
gtk/kde/whatever).

This version requires /dev/sonypi which is available from
http://www.alcove-labs.org/en/software/sonypi/
(or possibly built into 2.4.6+ kernels).


Quick start
-----------

Do "make run" to compile and test the program.
Turn the wheel to scroll windows (emulates mouse wheel buttons). If you
get X11 errors, edit plugins/jogdialrc to emulate PageUp/PageDown instead.
Click the wheel to activate the menu.
Turn and click the wheel to navigate the menu.
Click the "capture" or some Fn + key combination to run user
programmable applications. Try Fn-1.


Description
-----------

jogdiald reads a configuration file and plugins from /etc/jogdial/
(overriden by argv[1]). Plugins communicate with jogdiald through an
ascii-based protocol on stdin/stdout (see README.protocol). This way,
common system utilities can be wrapped in simple shell scripts.
Samples are provided in ./plugins/ .


Security
--------

Although some plugins need root permissions, you should *not* install
jogdiald setuid root on a shared machine. Otherwise anybody could
execute it with their own configuration file and plugins.


Known problems
--------------

- The sample plugins have been tested only on a Red Hat 6.2 system.

- A buggy plugin may hang jogdiald. Should add timeout negociation.

- Blank characters cannot be quoted in jogdialrc.

- Mouse_4/5 events cause error messages if the X server does not
  support 5-button mice.


-- Pascal Brisset - http://perso.wanadoo.fr/pascal.brisset/vaio/vaio.html
