It is advised that the entire README is read through first...
-------------------------------------------------------------------------------
This is the README for v0.0.2 of the Linux port of Handy v0.40 by Steven Fuller
<steveflr@ibm.net> [http://emu.simplenet.com/lynx]

Handy, the Atari Lynx emulator, is developed by Keith Wilkins
<keith.wilkins@nectech.co.uk> 
[http://www.geocities.com/SiliconValley/Heights/1148]

handy is a binary compiled with gcc 2.7.2.2, and phandy is compiled with
pgcc-102397 (optimized for pentium)

usage of handy:
	handy [-h] [-b <lynxboot.img>] <game image in .lnx format> 
	      [-s <sound log file>] [-c <cycles>]

-h gives basic param help
-b specifies which lynx boot image to use
-s lets the the sound to be logged to a file, which can be then played back
   via cat sound log > /dev/dsp etc/
-c is an experimental option that tells how many cpu loops to do before
   refreshing keyboard/sound/video etc. experiement for best results. default
   is 1024.

the game image has to be in Handy's lnx format at this time, the raw format
(and homebrew games) isn't supported at this time.

Keys:
[ENTER]      - Pause
[LEFT CTRL]  - B Button
[LEFT ALT]   - A Button
[1]          - Option 1
[2]          - Option 2
[F5]         - CPU Reset
[ESC]        - Kill Emulator


this is basically an alpha/beta/test/blah release so discretion is advised,
there are many things to add/fix/change/etc, so be patient.

this version is svgalib only, and was linked to:

        libvga.so.1 => /lib/libvga.so.1 (libvga.1.2.11)
        libc.so.5 => /lib/libc.so.5 (libc.so.5.4.33)

You need a lynx boot image and some lynx roms for this emulator of course,
so go search for them on the internet, they are not hard to find, so I will
not tell you where to find them.  the supplied lynxboot.img is false so a
real one is required to run any games.

linux binaries of make_lnx (a program to add/modify the Handy header for
lynx roms) and rotate (to modify the rotate bits of the Handy header) are
also given. just execute the program for more information.

if you find any bugs with the emulator in terms of emulation (gfx, sound) or 
other things (command line, file loading, window display, etc) check this
readme, the given web pages, then email me if that bug is not already known.


thanks... and have fun.

-------------------------------------------------------------------------------
