
                              -(( S-Jog ))-

-[ Intro ]----------------------------------------------------------------------

The aim of S-Jog is to give Linux a nice graphical application to manage
Jog-Dial wheel on Sony Vaio laptops. It utilizes the Sony Programmable I/O
driver in recent 2.4.x kernels or the legacy SPIC driver provided in S-Jog
distribution.

Currently, S-Jog is able to launch applications defined in the sjogrc file,
adjust the screen brightness level and also the master volume of the sound
card. Also S-Jog makes the Jog-Dial work like a mousewheel and it runs in
background.


-[ Configuration ]--------------------------------------------------------------

The default application list is read from the file $sysconfdir/sjogrc (usually
/usr/local/etc/sjogrc or /etc/sjogrc). To have your own list, copy this file to
$HOME/.sjogrc and edit it with your favorite text editor. The file is quite
simple to understand, each line represents an entry, the 1st word is the entry
label and the second is the name or the path of the application to launch.

There is 2 special tokens that can be put in the sjogrc file, the 1st if
"brightness" and the 2nd is "volume". Each one will open the corresponding
setting window instead of launching an application.

                               --oOo--

The mousewheel emulation can work in 2 different ways. The default behavior is
to send fake mouse button events. The events fired simulate buttons 4 and 5 so
be sure to tell X you have a 5 buttons mouse by adding the following line to
your /etc/X11/XF86Config-4 in "InputDevice" section:

    Option "Buttons" "5"

Without this line, expect random crashes from gdk or gtk but you have been
warned :)

The second behavior is to send page up/down fake key events to the X server and
it should work without problem.  


-[ Note ]-----------------------------------------------------------------------

If you use and like this application, please let me know it will give me some
more motivation to enhance it ;)


    -- Sylvain <sjog@tootella.org>.
