welcome to games-emulation

12 files changed, 1533 insertions, 0 deletions

diff --git a/games-emulation/atari800/files/1.2.2/atari800.1 b/games-emulation/atari800/files/1.2.2/atari800.1
new file mode 100644
index 000000000000..3484b327e6f2
--- /dev/null
+++ b/games-emulation/atari800/files/1.2.2/atari800.1
@@ -0,0 +1,661 @@
+.TH ATARI800 1 "26 February 2002"
+.SH NAME
+atari800 \- Atari 800 Emulator, Version 1.2.2
+.SH SYNOPSIS
+\fBatari800\fP [options] [diskfiles...]
+.SH DESCRIPTION
+\fIatari800\fP emulates the Atari 800, Atari 800 XL, Atari 130 XE and
+Atari 5200 Games System.
+.SS Options
+.TP
+\fB-help
+Print emulator version.
+.TP
+\fB-v
+Print emulator version.
+.TP
+\fB-verbose
+Display framerate when exiting
+.TP
+\fB-configure
+Starts emulator in run-time configuration mode.
+.TP
+\fB-config filename
+Specify an alternative configuration filename.
+
+.TP
+\fB-osa_rom filename
+Path to file containing Atari Rev.A Operating System.
+Used to override paths defined at compile time.
+.TP
+\fB-osb_rom filename
+Path to file containing Atari Rev.B Operating System.
+Used to override paths defined at compile time.
+.TP
+\fB-xlxe_rom filename
+Path to file containing Atari XL/XE Operating System.
+Used to override paths defined at compile time.
+.TP
+\fB-5200_rom filename
+Path to file containing Atari 5200 Games System ROM.
+Used to override paths defined at compile time.
+.TP
+\fB-basic_rom filename
+Path to file containing Atari BASIC ROM.
+Used to override paths defined at compile time.
+
+.TP
+\fB-xl
+Emulate Atari 800 XL.
+.TP
+\fB-xe
+Emulate Atari 130 XE - but Antic accesses the same bank the CPU is using.
+.TP
+\fB-320xe
+Emulate Atari 320 XE (Compy Shop)
+.TP
+\fB-rambo
+Emulate Atari 320 XE (Rambo)
+.TP
+\fB-5200
+Emulate Atari 5200 - Games controller emulation has not been implemented yet!
+.TP
+\fB-emuos
+Use EmuOS
+
+.TP
+\fB-a
+Use Atari OS/A.
+.TP
+\fB-b
+Use Atari OS/B.
+.TP
+\fB-c
+Enable RAM between $c000 and $d000.
+
+.TP
+\fB-pal                
+Emulate PAL TV mode
+.TP
+\fB-ntsc               
+Emulate NTSC TV mode
+
+.TP
+\fB-nobasic
+Used to disable Basic when starting the emulator in XL/XE mode.
+Simulates the Option key being held down during system boot.
+.TP
+\fB-basic
+Turn on Atari BASIC ROM
+
+.TP
+\fB-cart <filename>    
+Insert cartridge (CART or raw format)
+.TP
+\fB-run <filename>     
+Run Atari executable file (EXE, COM, XEX)
+.TP
+\fB-tape <filename>    
+Attach cassette image (CAS format or raw file)
+.TP
+\fB-boottape <filename>
+Attach cassette image and boot it
+
+.TP
+\fB-nopatch
+Normally the OS is patched giving very fast I/O. This options prevents
+the patch from being applied so that the OS accesses the serial port
+hardware directly. This option will probably never be needed since
+programs that access the serial hardware should work even if the OS
+has been patched.
+.TP
+\fB-nopatchall         
+Don't patch OS at all, H: and P: devices won't work
+
+.TP
+\fB-H1 <path>          
+Set path for H1: device
+.TP
+\fB-H2 <path>          
+Set path for H2: device
+.TP
+\fB-H3 <path>          
+Set path for H3: device
+.TP
+\fB-H4 <path>          
+Set path for H4: device
+.TP
+\fB-hdreadonly <onoff> 
+Enable (1) or disable (0) read-only mode for H: device
+.TP
+\fB-devbug             
+Put debugging messages for H: and P: devices in log file
+
+.TP
+\fB-rtime <onoff>      
+Enable (1) or disable (0) R-Time 8 emulation
+
+.TP
+\fB-mouse off          
+Do not use mouse
+.TP
+\fB-mouse pad          
+Emulate paddles
+.TP
+\fB-mouse touch        
+Emulate Atari Touch Tablet
+.TP
+\fB-mouse koala        
+Emulate Koala Pad
+.TP
+\fB-mouse pen          
+Emulate Light Pen
+.TP
+\fB-mouse gun          
+Emulate Light Gun
+.TP
+\fB-mouse amiga        
+Emulate Amiga mouse
+.TP
+\fB-mouse st           
+Emulate Atari ST mouse
+.TP
+\fB-mouse trak         
+Emulate Atari Trak-Ball
+.TP
+\fB-mouse joy          
+Emulate joystick using mouse
+.TP
+\fB-mouseport <num>    
+Set mouse port 1-4 (default 1)
+.TP
+\fB-mousespeed <num>   
+Set mouse speed 1-9 (default 3)
+
+.TP
+\fB-refresh
+Controls screen refresh rate. A numerical value follows this option
+which specifies how many emulated screen updates are required before
+the actual screen is updated. This value effects the speed of the
+emulation: A higher value results in faster CPU emulation but a
+less frequently updated screen.
+
+.TP
+\fB-artif <mode>       
+Set artifacting mode 0-4 (0 = disable)
+.TP
+\fB-palette <filename> 
+Read Atari colors from ACT file
+.TP
+\fB-black <num>        
+Set black level 0-255
+.TP
+\fB-while <num>        
+Set white level 0-255
+.TP
+\fB-colors <num>       
+Set color intensity
+.TP
+\fB-colshift <num>     
+Set color shift
+.TP
+\fB-realpal            
+Use palette created by Zdenek Eisenhammer
+.TP
+\fB-oldpal             
+Use old Atari800 palette
+.TP
+\fB-foxpal             
+Use palette created by Piotr Fusik
+
+.TP
+\fB-sound              
+Enable sound
+.TP
+\fB-nosound            
+Disable sound
+.TP
+\fB-dsprate <freq>     
+Set mixing frequency (Hz)
+.TP
+\fB-snddelay <time>    
+Set sound delay (milliseconds)
+
+
+.SS Curses Options
+.TP
+\fB-left
+Use columns 0 to 39.
+.TP
+\fB-central
+Use columns 20 to 59.
+.TP
+\fB-right
+Use columns 40 to 79.
+.TP
+\fB-wide1
+Use columns 0 to 79. In this mode only the even character positions
+are used. The odd locations are filled with spaces.
+.TP
+\fB-wide2
+Use columns 0 to 79. This mode is similar to \fB-wide1\fP except that
+the spaces are in reverse video if the previous character was also
+in reverse video.
+
+
+.SS Falcon Options
+.TP
+\fB-interlace <x>      
+Generate Falcon screen only every x frame
+.TP
+\fB-videl              
+Direct VIDEL programming (Falcon/VGA only)
+.TP
+\fB-double             
+Double the screen size on NOVA
+.TP
+\fB-delta              
+Delta screen output (differences only)
+
+.SS SVGALIB Options
+.TP
+\fB-interlace
+Enable screen interlace option
+
+
+.SS DOS/VGA Options
+.TP
+\fB-interlace          
+Generate screen with interlace
+.TP
+\fB-video <mode>       
+0=320x200, 1=320x240, 2=320x480 interlaced with black lines, 3=320x480 interlaced with darker lines
+.TP
+\fB-novesa             
+Do not use VESA 2 video modes
+.TP
+\fB-vretrace           
+Use vertical retrace control
+
+.TP
+\fB-LPTjoy1            
+Read joystick connected to LPT1
+.TP
+\fB-LPTjoy2            
+Read joystick connected to LPT2
+.TP
+\fB-LPTjoy3            
+Read joystick connected to LPT3
+.TP
+\fB-joyswap            
+Swap joysticks
+
+.TP
+\fB-keyboard 0         
+PC keyboard layout
+.TP
+\fB-keyboard 1         
+Atari keyboard layout
+
+
+.SS X11 Options
+.TP
+\fB-small
+Runs the emulator in a small window where each Atari 800 pixel is
+represented by one X Window pixel.
+.TP
+\fB-large
+Runs the emulator in a large window where each Atari 800 pixel is
+represented by a 2x2 X Window rectange. This mode is selected by
+default.
+.TP
+\fB-huge
+Runs the emulator in a huge window where each Atari 800 pixel is
+represented by a 3x3 X Window rectange.
+.TP
+\fB-clip_x number-of-pixels
+Sets left offset for clipping.
+.TP
+\fB-clip_width number-of-pixels
+Sets the width of the clipping-area.
+.TP
+\fB-clip_y number-of-pixels
+Sets top offset for clipping.
+.TP
+\fB-clip_height number-of-pixels
+Sets the height of the clipping-area.
+.TP
+\fB-private_cmap
+Tells the Emulator to use its own private colormap.
+.TP
+\fB-fps                
+Show framerate
+.TP
+\fB-sio                
+Show SIO monitor
+.TP
+\fB-x11bug             
+Enable debug code in atari_x11.c
+
+.TP
+\fB-keypad             
+Keypad mode
+
+.SS SDL Options
+.PP
+No SDL-specific options at this time
+
+.PD 0
+
+.SH KEYBOARD, JOYSTICK & PADDLE CONTROLS
+
+.SS Curses
+.TP
+\fBF1
+Built in User Interface
+.TP
+\fBF2
+Option
+.TP
+\fBF3
+Select
+.TP
+\fBF4
+Start
+.TP
+\fBF5
+Warm Reset
+.TP
+\fBF6
+Toggle RAM/ROM between 0x8000 and 0xbfff (PIL Mode)
+.TP
+\fBF7
+Break Key
+.TP
+\fBF8
+Cold Reset
+.TP
+\fBF9
+Exit Emulator
+.TP
+\fBF10
+---
+.TP
+\fBF11
+---
+.TP
+\fBF12
+---
+
+.PP
+Some control have special meaning within curses and should not be used.
+
+    Avoid Control + C, J, M, Q, S and Z
+
+The remaining control characters can be typed. Control characters are
+displayed on the screen with the associated upper case character in bold.
+
+No Joystick or Paddle support in this version.
+
+.SS Falcon
+.TP
+\fBF1
+Built in User Interface
+.TP
+\fBF2
+Option
+.TP
+\fBF3
+Select
+.TP
+\fBF4
+Start
+.TP
+\fBF5
+Warm Reset
+.TP
+\fBShft+F5
+Cold Reset
+.TP
+\fBF6
+Toggle RAM/ROM between 0x8000 and 0xbfff (PIL Mode)
+.TP
+\fBF7
+Break Key
+.TP
+\fBF8
+Enter monitor
+.TP
+\fBF9
+EXIT Emulator
+.TP
+\fBHelp
+HELP key (800XL/130XE)
+
+.PP
+Joystick 0 is operated by the numeric keypad (make sure that the numeric
+keypad has been enabled).
+ 
+        7 8 9
+         \\|/
+        4 5 6
+         /|\\
+        1 2 3
+ 
+        And 0 is the fire key.
+ 
+At the moment it is not possible to use a Paddle with this version.
+
+.SS SVGALIB
+.TP
+\fBF1
+Built in User Interface
+.TP
+\fBF2
+Option
+.TP
+\fBF3
+Select
+.TP
+\fBF4
+Start
+.TP
+\fBF5
+Warm Reset
+.TP
+\fBShft+F5
+Cold Reset
+.TP
+\fBF6
+Toggle RAM/ROM between 0x8000 and 0xbfff (PIL Mode)
+.TP
+\fBF7
+Break Key
+.TP
+\fBF8
+Enter monitor
+.TP
+\fBF9
+Exit Emulator
+.TP
+\fBF10
+Save Screenshot (+Shift=interlaced screenshot)
+.TP
+\fBF11
+Joystick Autofire On/Off
+.TP
+\fBF12
+---
+.TP
+\fB`
+This character replaces the CAPS lock key because I have not found a
+way of detecting it. A future solution maybe to automatically issue a
+CAPS lock key when a transition is made between lower and upper case
+keys. i.e. If svgalib return 'a' followed by 'A' it could send 'a'
+'CAPS' 'A' to the Atari.
+
+.PP
+The CTRL+SHIFT keyboard combinations are implemented using the left
+ALT key.
+
+Joystick 0 is operated by the numeric keypad (make sure that the numeric
+keypad has been enabled).
+
+        7 8 9
+         \\|/
+        4 5 6
+         /|\\
+        1 2 3
+
+        And 0 is the fire key.
+
+At the moment it is not possible to use a Paddle with the SVGALIB
+version.
+
+.SS DOS/VGA
+.TP
+\fBF1
+Built in User Interface
+.TP
+\fBF2
+Option Key
+.TP
+\fBF3
+Select Key
+.TP
+\fBF4
+Start Key
+.TP
+\fBF5
+Warm Reset
+.TP
+\fBShft+F5
+Cold Reset
+.TP
+\fBF6
+PIL Mode (Atari800) / Help Key (XL/XE)
+.TP
+\fBF7
+Switch between Emulated joysticks mode and Normal keyboard
+.TP
+\fBF8
+Enter monitor
+.TP
+\fBF9
+EXIT Emulator
+.TP
+\fBF10
+Save Screenshot (+Shift=interlaced screenshot)
+
+.PP
+Control-C terminates the program; to type Control-c, type ALT-c instead.
+` is used as the Atari-Invers key
+
+Joysticks can be either real one connected to game port, or old 8-bit
+digital CX-40 joysticks connected to parallel port or keyboard joysticks
+(try out JOYCFG.EXE).
+ 
+At the moment it is not possible to use a Paddle with this version.
+
+.SS X11
+.TP
+\fBF1
+Built in User Interface
+.TP
+\fBF2
+Option
+.TP
+\fBF3
+Select
+.TP
+\fBF4
+Start
+.TP
+\fBF5
+Warm Reset
+.TP
+\fBShft+F5
+Cold Reset
+.TP
+\fBF6
+Toggle RAM/ROM between 0x8000 and 0xbfff (PIL Mode)
+.TP
+\fBF7
+Break Key
+.TP
+\fBF8
+---
+.TP
+\fBF9
+Exit Emulator
+.TP
+\fBF10
+---
+.TP
+\fBF11
+Vertical Positioning: Scroll Screen Downwards
+.TP
+\fBF12
+Vertical Positioning: Scroll Screen Upwards
+.TP
+\fBALT
+Atari Key (Either ALT Key will work)
+
+.PP
+Joystick 0 is operated by the mouse position relative to the center of
+the screen. The mouse button acts as the trigger.  On Linux, standard
+joysticks are also supported.
+
+Paddle 0 is operated by moving the mouse pointer across the window.
+
+.SS SDL
+.TP
+\fBLALT+f
+switching FULLSCREEN (probably doesn't work in Windows)
+.TP
+\fBLALT+g
+switching WIDTH_MODE (so you can set 320x240)
+.TP
+\fBLALT+b
+switching BLACK-AND-WHITE (feel to power of BW monitor!)
+.TP
+\fBLALT+j
+swapping _keyboard_emulated_ joysticks
+.TP
+\fBLALT+e
+switching bpp (for debug only, will be removed soon)
+
+.PP
+To redefine keys for joystick emulation you must modify SDL_TRIG_* and
+SDL_JOY_* in atari_sdl.c, then recompile Atari800. In source you can
+also turn off sound or change defaults (FULLSCREEN, BW,
+SWAP_JOYSTICKS, WIDTH_MODE).
+
+On Linux, standard joysticks are supported.
+
+
+.PD 1
+
+.SH FILES
+.TP
+\fI/usr/share/atari800/ATARIOSA.ROM\fR
+Atari O/S A
+.TP
+\fI/usr/share/atari800/ATARIOSB.ROM\fR
+Atari O/S B
+.TP
+\fI/usr/share/atari800/ATARIXL.ROM\fR
+Atari 800 XL O/S
+.TP
+\fI/usr/share/atari800/ATARI5200.ROM\fR
+Atari 5200 O/S
+.TP
+\fI/usr/share/atari800/ATARIBAS.ROM\fR
+Atari Basic
+.SH BUGS
+A few programs cause the emulator to enter its built in debugger. The
+reason for this is unknown at the moment.
+
+The SDL port doesn't seem to recognize the
+.B -help
+option.
\ No newline at end of file
diff --git a/games-emulation/atari800/files/1.2.2/atari800.cfg b/games-emulation/atari800/files/1.2.2/atari800.cfg
new file mode 100644
index 000000000000..aae3f9b51fa2
--- /dev/null
+++ b/games-emulation/atari800/files/1.2.2/atari800.cfg
@@ -0,0 +1,24 @@
+Atari 800 Emulator, Version 1.2.2
+OS/A_ROM=atariosa.rom
+OS/B_ROM=/usr/share/atari800/ATARIOSB.ROM
+XL/XE_ROM=/usr/share/atari800/ATARIXL.ROM
+BASIC_ROM=/usr/share/atari800/ATARIBAS.ROM
+5200_ROM=
+DISK_DIR=
+ROM_DIR=
+H1_DIR=
+H2_DIR=
+H3_DIR=
+H4_DIR=
+HD_READ_ONLY=1
+EXE_DIR=
+STATE_DIR=
+PRINT_COMMAND=lpr %s
+SCREEN_REFRESH_RATIO=1
+MACHINE_TYPE=Atari OS/B
+RAM_SIZE=48
+DEFAULT_TV_MODE=NTSC
+DISABLE_BASIC=1
+ENABLE_SIO_PATCH=1
+ENABLE_H_PATCH=1
+ENABLE_P_PATCH=1
diff --git a/games-emulation/atari800/files/1.2.5/atari800.1 b/games-emulation/atari800/files/1.2.5/atari800.1
new file mode 100644
index 000000000000..3484b327e6f2
--- /dev/null
+++ b/games-emulation/atari800/files/1.2.5/atari800.1
@@ -0,0 +1,661 @@
+.TH ATARI800 1 "26 February 2002"
+.SH NAME
+atari800 \- Atari 800 Emulator, Version 1.2.2
+.SH SYNOPSIS
+\fBatari800\fP [options] [diskfiles...]
+.SH DESCRIPTION
+\fIatari800\fP emulates the Atari 800, Atari 800 XL, Atari 130 XE and
+Atari 5200 Games System.
+.SS Options
+.TP
+\fB-help
+Print emulator version.
+.TP
+\fB-v
+Print emulator version.
+.TP
+\fB-verbose
+Display framerate when exiting
+.TP
+\fB-configure
+Starts emulator in run-time configuration mode.
+.TP
+\fB-config filename
+Specify an alternative configuration filename.
+
+.TP
+\fB-osa_rom filename
+Path to file containing Atari Rev.A Operating System.
+Used to override paths defined at compile time.
+.TP
+\fB-osb_rom filename
+Path to file containing Atari Rev.B Operating System.
+Used to override paths defined at compile time.
+.TP
+\fB-xlxe_rom filename
+Path to file containing Atari XL/XE Operating System.
+Used to override paths defined at compile time.
+.TP
+\fB-5200_rom filename
+Path to file containing Atari 5200 Games System ROM.
+Used to override paths defined at compile time.
+.TP
+\fB-basic_rom filename
+Path to file containing Atari BASIC ROM.
+Used to override paths defined at compile time.
+
+.TP
+\fB-xl
+Emulate Atari 800 XL.
+.TP
+\fB-xe
+Emulate Atari 130 XE - but Antic accesses the same bank the CPU is using.
+.TP
+\fB-320xe
+Emulate Atari 320 XE (Compy Shop)
+.TP
+\fB-rambo
+Emulate Atari 320 XE (Rambo)
+.TP
+\fB-5200
+Emulate Atari 5200 - Games controller emulation has not been implemented yet!
+.TP
+\fB-emuos
+Use EmuOS
+
+.TP
+\fB-a
+Use Atari OS/A.
+.TP
+\fB-b
+Use Atari OS/B.
+.TP
+\fB-c
+Enable RAM between $c000 and $d000.
+
+.TP
+\fB-pal                
+Emulate PAL TV mode
+.TP
+\fB-ntsc               
+Emulate NTSC TV mode
+
+.TP
+\fB-nobasic
+Used to disable Basic when starting the emulator in XL/XE mode.
+Simulates the Option key being held down during system boot.
+.TP
+\fB-basic
+Turn on Atari BASIC ROM
+
+.TP
+\fB-cart <filename>    
+Insert cartridge (CART or raw format)
+.TP
+\fB-run <filename>     
+Run Atari executable file (EXE, COM, XEX)
+.TP
+\fB-tape <filename>    
+Attach cassette image (CAS format or raw file)
+.TP
+\fB-boottape <filename>
+Attach cassette image and boot it
+
+.TP
+\fB-nopatch
+Normally the OS is patched giving very fast I/O. This options prevents
+the patch from being applied so that the OS accesses the serial port
+hardware directly. This option will probably never be needed since
+programs that access the serial hardware should work even if the OS
+has been patched.
+.TP
+\fB-nopatchall         
+Don't patch OS at all, H: and P: devices won't work
+
+.TP
+\fB-H1 <path>          
+Set path for H1: device
+.TP
+\fB-H2 <path>          
+Set path for H2: device
+.TP
+\fB-H3 <path>          
+Set path for H3: device
+.TP
+\fB-H4 <path>          
+Set path for H4: device
+.TP
+\fB-hdreadonly <onoff> 
+Enable (1) or disable (0) read-only mode for H: device
+.TP
+\fB-devbug             
+Put debugging messages for H: and P: devices in log file
+
+.TP
+\fB-rtime <onoff>      
+Enable (1) or disable (0) R-Time 8 emulation
+
+.TP
+\fB-mouse off          
+Do not use mouse
+.TP
+\fB-mouse pad          
+Emulate paddles
+.TP
+\fB-mouse touch        
+Emulate Atari Touch Tablet
+.TP
+\fB-mouse koala        
+Emulate Koala Pad
+.TP
+\fB-mouse pen          
+Emulate Light Pen
+.TP
+\fB-mouse gun          
+Emulate Light Gun
+.TP
+\fB-mouse amiga        
+Emulate Amiga mouse
+.TP
+\fB-mouse st           
+Emulate Atari ST mouse
+.TP
+\fB-mouse trak         
+Emulate Atari Trak-Ball
+.TP
+\fB-mouse joy          
+Emulate joystick using mouse
+.TP
+\fB-mouseport <num>    
+Set mouse port 1-4 (default 1)
+.TP
+\fB-mousespeed <num>   
+Set mouse speed 1-9 (default 3)
+
+.TP
+\fB-refresh
+Controls screen refresh rate. A numerical value follows this option
+which specifies how many emulated screen updates are required before
+the actual screen is updated. This value effects the speed of the
+emulation: A higher value results in faster CPU emulation but a
+less frequently updated screen.
+
+.TP
+\fB-artif <mode>       
+Set artifacting mode 0-4 (0 = disable)
+.TP
+\fB-palette <filename> 
+Read Atari colors from ACT file
+.TP
+\fB-black <num>        
+Set black level 0-255
+.TP
+\fB-while <num>        
+Set white level 0-255
+.TP
+\fB-colors <num>       
+Set color intensity
+.TP
+\fB-colshift <num>     
+Set color shift
+.TP
+\fB-realpal            
+Use palette created by Zdenek Eisenhammer
+.TP
+\fB-oldpal             
+Use old Atari800 palette
+.TP
+\fB-foxpal             
+Use palette created by Piotr Fusik
+
+.TP
+\fB-sound              
+Enable sound
+.TP
+\fB-nosound            
+Disable sound
+.TP
+\fB-dsprate <freq>     
+Set mixing frequency (Hz)
+.TP
+\fB-snddelay <time>    
+Set sound delay (milliseconds)
+
+
+.SS Curses Options
+.TP
+\fB-left
+Use columns 0 to 39.
+.TP
+\fB-central
+Use columns 20 to 59.
+.TP
+\fB-right
+Use columns 40 to 79.
+.TP
+\fB-wide1
+Use columns 0 to 79. In this mode only the even character positions
+are used. The odd locations are filled with spaces.
+.TP
+\fB-wide2
+Use columns 0 to 79. This mode is similar to \fB-wide1\fP except that
+the spaces are in reverse video if the previous character was also
+in reverse video.
+
+
+.SS Falcon Options
+.TP
+\fB-interlace <x>      
+Generate Falcon screen only every x frame
+.TP
+\fB-videl              
+Direct VIDEL programming (Falcon/VGA only)
+.TP
+\fB-double             
+Double the screen size on NOVA
+.TP
+\fB-delta              
+Delta screen output (differences only)
+
+.SS SVGALIB Options
+.TP
+\fB-interlace
+Enable screen interlace option
+
+
+.SS DOS/VGA Options
+.TP
+\fB-interlace          
+Generate screen with interlace
+.TP
+\fB-video <mode>       
+0=320x200, 1=320x240, 2=320x480 interlaced with black lines, 3=320x480 interlaced with darker lines
+.TP
+\fB-novesa             
+Do not use VESA 2 video modes
+.TP
+\fB-vretrace           
+Use vertical retrace control
+
+.TP
+\fB-LPTjoy1            
+Read joystick connected to LPT1
+.TP
+\fB-LPTjoy2            
+Read joystick connected to LPT2
+.TP
+\fB-LPTjoy3            
+Read joystick connected to LPT3
+.TP
+\fB-joyswap            
+Swap joysticks
+
+.TP
+\fB-keyboard 0         
+PC keyboard layout
+.TP
+\fB-keyboard 1         
+Atari keyboard layout
+
+
+.SS X11 Options
+.TP
+\fB-small
+Runs the emulator in a small window where each Atari 800 pixel is
+represented by one X Window pixel.
+.TP
+\fB-large
+Runs the emulator in a large window where each Atari 800 pixel is
+represented by a 2x2 X Window rectange. This mode is selected by
+default.
+.TP
+\fB-huge
+Runs the emulator in a huge window where each Atari 800 pixel is
+represented by a 3x3 X Window rectange.
+.TP
+\fB-clip_x number-of-pixels
+Sets left offset for clipping.
+.TP
+\fB-clip_width number-of-pixels
+Sets the width of the clipping-area.
+.TP
+\fB-clip_y number-of-pixels
+Sets top offset for clipping.
+.TP
+\fB-clip_height number-of-pixels
+Sets the height of the clipping-area.
+.TP
+\fB-private_cmap
+Tells the Emulator to use its own private colormap.
+.TP
+\fB-fps                
+Show framerate
+.TP
+\fB-sio                
+Show SIO monitor
+.TP
+\fB-x11bug             
+Enable debug code in atari_x11.c
+
+.TP
+\fB-keypad             
+Keypad mode
+
+.SS SDL Options
+.PP
+No SDL-specific options at this time
+
+.PD 0
+
+.SH KEYBOARD, JOYSTICK & PADDLE CONTROLS
+
+.SS Curses
+.TP
+\fBF1
+Built in User Interface
+.TP
+\fBF2
+Option
+.TP
+\fBF3
+Select
+.TP
+\fBF4
+Start
+.TP
+\fBF5
+Warm Reset
+.TP
+\fBF6
+Toggle RAM/ROM between 0x8000 and 0xbfff (PIL Mode)
+.TP
+\fBF7
+Break Key
+.TP
+\fBF8
+Cold Reset
+.TP
+\fBF9
+Exit Emulator
+.TP
+\fBF10
+---
+.TP
+\fBF11
+---
+.TP
+\fBF12
+---
+
+.PP
+Some control have special meaning within curses and should not be used.
+
+    Avoid Control + C, J, M, Q, S and Z
+
+The remaining control characters can be typed. Control characters are
+displayed on the screen with the associated upper case character in bold.
+
+No Joystick or Paddle support in this version.
+
+.SS Falcon
+.TP
+\fBF1
+Built in User Interface
+.TP
+\fBF2
+Option
+.TP
+\fBF3
+Select
+.TP
+\fBF4
+Start
+.TP
+\fBF5
+Warm Reset
+.TP
+\fBShft+F5
+Cold Reset
+.TP
+\fBF6
+Toggle RAM/ROM between 0x8000 and 0xbfff (PIL Mode)
+.TP
+\fBF7
+Break Key
+.TP
+\fBF8
+Enter monitor
+.TP
+\fBF9
+EXIT Emulator
+.TP
+\fBHelp
+HELP key (800XL/130XE)
+
+.PP
+Joystick 0 is operated by the numeric keypad (make sure that the numeric
+keypad has been enabled).
+ 
+        7 8 9
+         \\|/
+        4 5 6
+         /|\\
+        1 2 3
+ 
+        And 0 is the fire key.
+ 
+At the moment it is not possible to use a Paddle with this version.
+
+.SS SVGALIB
+.TP
+\fBF1
+Built in User Interface
+.TP
+\fBF2
+Option
+.TP
+\fBF3
+Select
+.TP
+\fBF4
+Start
+.TP
+\fBF5
+Warm Reset
+.TP
+\fBShft+F5
+Cold Reset
+.TP
+\fBF6
+Toggle RAM/ROM between 0x8000 and 0xbfff (PIL Mode)
+.TP
+\fBF7
+Break Key
+.TP
+\fBF8
+Enter monitor
+.TP
+\fBF9
+Exit Emulator
+.TP
+\fBF10
+Save Screenshot (+Shift=interlaced screenshot)
+.TP
+\fBF11
+Joystick Autofire On/Off
+.TP
+\fBF12
+---
+.TP
+\fB`
+This character replaces the CAPS lock key because I have not found a
+way of detecting it. A future solution maybe to automatically issue a
+CAPS lock key when a transition is made between lower and upper case
+keys. i.e. If svgalib return 'a' followed by 'A' it could send 'a'
+'CAPS' 'A' to the Atari.
+
+.PP
+The CTRL+SHIFT keyboard combinations are implemented using the left
+ALT key.
+
+Joystick 0 is operated by the numeric keypad (make sure that the numeric
+keypad has been enabled).
+
+        7 8 9
+         \\|/
+        4 5 6
+         /|\\
+        1 2 3
+
+        And 0 is the fire key.
+
+At the moment it is not possible to use a Paddle with the SVGALIB
+version.
+
+.SS DOS/VGA
+.TP
+\fBF1
+Built in User Interface
+.TP
+\fBF2
+Option Key
+.TP
+\fBF3
+Select Key
+.TP
+\fBF4
+Start Key
+.TP
+\fBF5
+Warm Reset
+.TP
+\fBShft+F5
+Cold Reset
+.TP
+\fBF6
+PIL Mode (Atari800) / Help Key (XL/XE)
+.TP
+\fBF7
+Switch between Emulated joysticks mode and Normal keyboard
+.TP
+\fBF8
+Enter monitor
+.TP
+\fBF9
+EXIT Emulator
+.TP
+\fBF10
+Save Screenshot (+Shift=interlaced screenshot)
+
+.PP
+Control-C terminates the program; to type Control-c, type ALT-c instead.
+` is used as the Atari-Invers key
+
+Joysticks can be either real one connected to game port, or old 8-bit
+digital CX-40 joysticks connected to parallel port or keyboard joysticks
+(try out JOYCFG.EXE).
+ 
+At the moment it is not possible to use a Paddle with this version.
+
+.SS X11
+.TP
+\fBF1
+Built in User Interface
+.TP
+\fBF2
+Option
+.TP
+\fBF3
+Select
+.TP
+\fBF4
+Start
+.TP
+\fBF5
+Warm Reset
+.TP
+\fBShft+F5
+Cold Reset
+.TP
+\fBF6
+Toggle RAM/ROM between 0x8000 and 0xbfff (PIL Mode)
+.TP
+\fBF7
+Break Key
+.TP
+\fBF8
+---
+.TP
+\fBF9
+Exit Emulator
+.TP
+\fBF10
+---
+.TP
+\fBF11
+Vertical Positioning: Scroll Screen Downwards
+.TP
+\fBF12
+Vertical Positioning: Scroll Screen Upwards
+.TP
+\fBALT
+Atari Key (Either ALT Key will work)
+
+.PP
+Joystick 0 is operated by the mouse position relative to the center of
+the screen. The mouse button acts as the trigger.  On Linux, standard
+joysticks are also supported.
+
+Paddle 0 is operated by moving the mouse pointer across the window.
+
+.SS SDL
+.TP
+\fBLALT+f
+switching FULLSCREEN (probably doesn't work in Windows)
+.TP
+\fBLALT+g
+switching WIDTH_MODE (so you can set 320x240)
+.TP
+\fBLALT+b
+switching BLACK-AND-WHITE (feel to power of BW monitor!)
+.TP
+\fBLALT+j
+swapping _keyboard_emulated_ joysticks
+.TP
+\fBLALT+e
+switching bpp (for debug only, will be removed soon)
+
+.PP
+To redefine keys for joystick emulation you must modify SDL_TRIG_* and
+SDL_JOY_* in atari_sdl.c, then recompile Atari800. In source you can
+also turn off sound or change defaults (FULLSCREEN, BW,
+SWAP_JOYSTICKS, WIDTH_MODE).
+
+On Linux, standard joysticks are supported.
+
+
+.PD 1
+
+.SH FILES
+.TP
+\fI/usr/share/atari800/ATARIOSA.ROM\fR
+Atari O/S A
+.TP
+\fI/usr/share/atari800/ATARIOSB.ROM\fR
+Atari O/S B
+.TP
+\fI/usr/share/atari800/ATARIXL.ROM\fR
+Atari 800 XL O/S
+.TP
+\fI/usr/share/atari800/ATARI5200.ROM\fR
+Atari 5200 O/S
+.TP
+\fI/usr/share/atari800/ATARIBAS.ROM\fR
+Atari Basic
+.SH BUGS
+A few programs cause the emulator to enter its built in debugger. The
+reason for this is unknown at the moment.
+
+The SDL port doesn't seem to recognize the
+.B -help
+option.
\ No newline at end of file
diff --git a/games-emulation/atari800/files/1.2.5/atari800.cfg b/games-emulation/atari800/files/1.2.5/atari800.cfg
new file mode 100644
index 000000000000..aae3f9b51fa2
--- /dev/null
+++ b/games-emulation/atari800/files/1.2.5/atari800.cfg
@@ -0,0 +1,24 @@
+Atari 800 Emulator, Version 1.2.2
+OS/A_ROM=atariosa.rom
+OS/B_ROM=/usr/share/atari800/ATARIOSB.ROM
+XL/XE_ROM=/usr/share/atari800/ATARIXL.ROM
+BASIC_ROM=/usr/share/atari800/ATARIBAS.ROM
+5200_ROM=
+DISK_DIR=
+ROM_DIR=
+H1_DIR=
+H2_DIR=
+H3_DIR=
+H4_DIR=
+HD_READ_ONLY=1
+EXE_DIR=
+STATE_DIR=
+PRINT_COMMAND=lpr %s
+SCREEN_REFRESH_RATIO=1
+MACHINE_TYPE=Atari OS/B
+RAM_SIZE=48
+DEFAULT_TV_MODE=NTSC
+DISABLE_BASIC=1
+ENABLE_SIO_PATCH=1
+ENABLE_H_PATCH=1
+ENABLE_P_PATCH=1
diff --git a/games-emulation/atari800/files/1.3.0/atari800.cfg b/games-emulation/atari800/files/1.3.0/atari800.cfg
new file mode 100644
index 000000000000..aae3f9b51fa2
--- /dev/null
+++ b/games-emulation/atari800/files/1.3.0/atari800.cfg
@@ -0,0 +1,24 @@
+Atari 800 Emulator, Version 1.2.2
+OS/A_ROM=atariosa.rom
+OS/B_ROM=/usr/share/atari800/ATARIOSB.ROM
+XL/XE_ROM=/usr/share/atari800/ATARIXL.ROM
+BASIC_ROM=/usr/share/atari800/ATARIBAS.ROM
+5200_ROM=
+DISK_DIR=
+ROM_DIR=
+H1_DIR=
+H2_DIR=
+H3_DIR=
+H4_DIR=
+HD_READ_ONLY=1
+EXE_DIR=
+STATE_DIR=
+PRINT_COMMAND=lpr %s
+SCREEN_REFRESH_RATIO=1
+MACHINE_TYPE=Atari OS/B
+RAM_SIZE=48
+DEFAULT_TV_MODE=NTSC
+DISABLE_BASIC=1
+ENABLE_SIO_PATCH=1
+ENABLE_H_PATCH=1
+ENABLE_P_PATCH=1
diff --git a/games-emulation/atari800/files/atari800-1.2.2-gentoo.diff b/games-emulation/atari800/files/atari800-1.2.2-gentoo.diff
new file mode 100644
index 000000000000..a9df9fdc32ce
--- /dev/null
+++ b/games-emulation/atari800/files/atari800-1.2.2-gentoo.diff
@@ -0,0 +1,12 @@
+diff -u -r atari800-1.2.2-ORIG/src/configure atari800-1.2.2/src/configure
+--- atari800-1.2.2-ORIG/src/configure	Mon Dec 31 06:16:27 2001
++++ atari800-1.2.2/src/configure	Mon Feb 25 10:15:47 2002
+@@ -883,7 +883,7 @@
+ 	;;
+   mingw32 ) a800_host=win;;
+   msdosdjgpp ) a800_host=dos;;
+-  linux ) a800_host=linux;;
++  *linux* ) a800_host=linux;;
+   mint ) a800_host=falcon;;
+ esac
+ 
diff --git a/games-emulation/atari800/files/atari800-1.2.5-gentoo.diff b/games-emulation/atari800/files/atari800-1.2.5-gentoo.diff
new file mode 100644
index 000000000000..9af2474f97e0
--- /dev/null
+++ b/games-emulation/atari800/files/atari800-1.2.5-gentoo.diff
@@ -0,0 +1,46 @@
+--- atari800-1.2.5/src/pokeysnd.c	2002-12-04 22:21:39.000000000 -0500
++++ atari800-1.2.4/src/pokeysnd.c	2001-07-22 04:24:47.000000000 -0400
+@@ -1,4 +1,4 @@
+-/* $Id: atari800-1.2.5-gentoo.diff,v 1.1 2003/09/09 16:26:49 vapier Exp $ */
++/* $Id: atari800-1.2.5-gentoo.diff,v 1.1 2003/09/09 16:26:49 vapier Exp $ */
+ /*****************************************************************************/
+ /*                                                                           */
+ /* Module:  POKEY Chip Emulator, V2.4                                        */
+@@ -533,8 +533,8 @@
+ 			/* or the channel is off (volume == 0) */
+ 			/* or the channel freq is greater than the playback freq */
+ 			if ( (AUDC[chan + chip_offs] & VOL_ONLY) ||
+-				((AUDC[chan + chip_offs] & VOLUME_MASK) == 0)
+-				/* || (Div_n_max[chan + chip_offs] < (Samp_n_max >> 8))*/) {
++				((AUDC[chan + chip_offs] & VOLUME_MASK) == 0) ||
++				(Div_n_max[chan + chip_offs] < (Samp_n_max >> 8))) {
+ 				/* indicate the channel is 'on' */
+ 				Outvol[chan + chip_offs] = 1;
+ 
+@@ -542,8 +542,8 @@
+ 				if ((chan == CHAN3 && !(AUDCTL[chip] & CH1_FILTER)) ||
+ 					(chan == CHAN4 && !(AUDCTL[chip] & CH2_FILTER)) ||
+ 					(chan == CHAN1) ||
+-					(chan == CHAN2)
+-					/* || (Div_n_max[chan + chip_offs] < (Samp_n_max >> 8))*/) {
++					(chan == CHAN2) ||
++					(Div_n_max[chan + chip_offs] < (Samp_n_max >> 8))) {
+ 					/* and set channel freq to max to reduce processing */
+ 					Div_n_max[chan + chip_offs] = 0x7fffffffL;
+ 					Div_n_cnt[chan + chip_offs] = 0x7fffffffL;
+@@ -1068,9 +1068,6 @@
+ 
+ /*
+ $Log: atari800-1.2.5-gentoo.diff,v $
+ Revision 1.1  2003/09/09 16:26:49  vapier
+ welcome to games-emulation
+
+ Revision 1.1  2003/01/31 22:01:10  rphillips
+ new version. masked. fixes #11605
+
+-Revision 1.9  2002/08/26 05:44:22  pfusik
+-Adam Bienias's fix for better sound quality
+-
+ Revision 1.8  2001/07/22 08:24:47  knik
+ PURE -> PURETONE to avoid windows headers interference
+ 
diff --git a/games-emulation/atari800/files/atari800-1.3.0-security.patch b/games-emulation/atari800/files/atari800-1.3.0-security.patch
new file mode 100644
index 000000000000..4f25ab684a6f
--- /dev/null
+++ b/games-emulation/atari800/files/atari800-1.3.0-security.patch
@@ -0,0 +1,73 @@
+--- atari.c-orig	2003-02-10 11:22:32.000000000 +0000
++++ atari.c	2003-07-31 23:58:35.000000000 +0100
+@@ -389,16 +389,57 @@
+ 			tv_mode = TV_PAL;
+ 		else if (strcmp(argv[i], "-ntsc") == 0)
+ 			tv_mode = TV_NTSC;
+-		else if (strcmp(argv[i], "-osa_rom") == 0)
+-			strcpy(atari_osa_filename, argv[++i]);
+-		else if (strcmp(argv[i], "-osb_rom") == 0)
+-			strcpy(atari_osb_filename, argv[++i]);
+-		else if (strcmp(argv[i], "-xlxe_rom") == 0)
+-			strcpy(atari_xlxe_filename, argv[++i]);
+-		else if (strcmp(argv[i], "-5200_rom") == 0)
+-			strcpy(atari_5200_filename, argv[++i]);
+-		else if (strcmp(argv[i], "-basic_rom") == 0)
+-			strcpy(atari_basic_filename, argv[++i]);
++		else if (strcmp(argv[i], "-osa_rom") == 0) {
++ 		        if ( (i+1) < *argc ) {
++			          memset(atari_osa_filename,'\0',sizeof(atari_osa_filename));
++			          strncpy(atari_osa_filename, argv[++i], sizeof(atari_osa_filename)-1);
++			}
++			else {
++			          printf("Missing argument for '-osa_rom'\n");
++				  return( 1 );
++			}
++
++		}
++		else if (strcmp(argv[i], "-osb_rom") == 0) {
++ 		        if ( (i+1) < *argc ) {
++			          memset(atari_osb_filename,'\0',sizeof(atari_osb_filename));
++			          strncpy(atari_osb_filename, argv[++i],sizeof(atari_osb_filename)-1);
++			}
++			else {
++			          printf("Missing argument for '-osb_rom'\n");
++				  return( 1 );
++			}
++		}
++		else if (strcmp(argv[i], "-xlxe_rom") == 0) {
++ 		        if ( (i+1) < *argc ) {
++			          memset(atari_xlxe_filename,'\0',sizeof(atari_xlxe_filename));
++			          strncpy(atari_xlxe_filename, argv[++i], sizeof(atari_xlxe_filename)-1);
++			}
++			else {
++			          printf("Missing argument for '-xlxe_rom'\n");
++				  return( 1 );
++			}
++		}
++		else if (strcmp(argv[i], "-5200_rom") == 0) {
++ 		        if ( (i+1) < *argc ) {
++			          memset(atari_5200_filename,'\0',sizeof(atari_5200_filename));
++			          strncpy(atari_5200_filename, argv[++i], sizeof(atari_5200_filename)-1);
++			}
++			else {
++			          printf("Missing argument for '-5200_rom'\n");
++				  return( 1 );
++			}
++		}
++		else if (strcmp(argv[i], "-basic_rom") == 0) {
++ 		        if ( (i+1) < *argc ) {
++			          memset(atari_basic_filename,'\0',sizeof(atari_basic_filename));
++			          strncpy(atari_basic_filename, argv[++i], sizeof(atari_basic_filename)-1);
++			}
++			else {
++			          printf("Missing argument for '-basic_rom'\n");
++				  return( 1 );
++			}
++		}
+ 		else if (strcmp(argv[i], "-cart") == 0) {
+ 			rom_filename = argv[++i];
+ 		}
+
+
+
diff --git a/games-emulation/atari800/files/digest-atari800-1.2.2 b/games-emulation/atari800/files/digest-atari800-1.2.2
new file mode 100644
index 000000000000..94e7a21c1990
--- /dev/null
+++ b/games-emulation/atari800/files/digest-atari800-1.2.2
@@ -0,0 +1,2 @@
+MD5 8e44b40722b4711af7affb135a13960f atari800-1.2.2.tar.gz 462135
+MD5 4dc3b6b4313e9596c4d474785a37b94d xf25.zip 188942
diff --git a/games-emulation/atari800/files/digest-atari800-1.2.5 b/games-emulation/atari800/files/digest-atari800-1.2.5
new file mode 100644
index 000000000000..6e2564a845d6
--- /dev/null
+++ b/games-emulation/atari800/files/digest-atari800-1.2.5
@@ -0,0 +1,2 @@
+MD5 9f4e90498414c307170b62ae3b8ade18 atari800-1.2.5.tar.gz 482781
+MD5 4dc3b6b4313e9596c4d474785a37b94d xf25.zip 188942
diff --git a/games-emulation/atari800/files/digest-atari800-1.3.0 b/games-emulation/atari800/files/digest-atari800-1.3.0
new file mode 100644
index 000000000000..3a9b403feff4
--- /dev/null
+++ b/games-emulation/atari800/files/digest-atari800-1.3.0
@@ -0,0 +1,2 @@
+MD5 2998586f3c69f8a7e50439722e30ffc6 atari800-1.3.0.tar.gz 671467
+MD5 4dc3b6b4313e9596c4d474785a37b94d xf25.zip 188942
diff --git a/games-emulation/atari800/files/digest-atari800-1.3.0-r1 b/games-emulation/atari800/files/digest-atari800-1.3.0-r1
new file mode 100644
index 000000000000..3a9b403feff4
--- /dev/null
+++ b/games-emulation/atari800/files/digest-atari800-1.3.0-r1
@@ -0,0 +1,2 @@
+MD5 2998586f3c69f8a7e50439722e30ffc6 atari800-1.3.0.tar.gz 671467
+MD5 4dc3b6b4313e9596c4d474785a37b94d xf25.zip 188942