Updates across the board wrt the manual and release files, etc. It looks

like the next release will be on July 17 (or I'll have to edit all these
files again).

Ran the various PNG images through pngcrush, which squeezed them
down a little.  Every little bit helps.

Included the latest version of my personal stella.pro file.  It seems that
the original maintainer for this file has gone MIA, so I guess that's
*yet another* thing I'll be maintaining ...


git-svn-id: svn://svn.code.sf.net/p/stella/code/trunk@308 8b62c5a3-ac7e-4cc8-8f21-d9a121418aba

stella/Announce.txt

@@ -9,27 +9,31 @@
      SSSS     ttt  eeeee llll llll  aaaaa
 
 ===============================================================================
-                     Release 1.3 for DOS, Linux, and Unix 
+                  Release 1.4 for Linux, Mac OSX and Windows
 ===============================================================================
 
 The Atari 2600 Video Computer System (VCS), introduced in 1977, was the most 
-popular home video game system of the early 1980's. Now you can enjoy all of 
+popular home video game system of the early 1980's.  Now you can enjoy all of 
 your favorite Atari 2600 games on your PC thanks to Stella! 
 
-Stella is a multi-platform Atari 2600 VCS emulator. It allows you to play all
+Stella is a multi-platform Atari 2600 VCS emulator.  It allows you to play all
-of your favorite Atari 2600 games again! Stella was originally developed for
+of your favorite Atari 2600 games again!  Stella was originally developed for
 Linux by Bradford W. Mott, however, it has been ported to a number of other
 platforms.
 
-This is the 1.3 release of Stella for DOS, Linux, and Unix. Distributions
+This is the 1.4 release of Stella for Linux, Mac OSX and Windows.  Distributions
-for other operating systems will appear as they become available. The three 
+for other operating systems will appear as they become available. The
 distributions currently available are:
 
-  * Binary distribution for Linux (stella-1.3-linux-x86.tar.gz)
+  * Binary distribution in RPM format for Linux (stella-1.4-1.i586.rpm)
 
-  * Binary distribution for DOS (st13.zip)
+  * Binary distribution for Mac OSX () FIXME
 
-  * Source code distribution for Linux, Unix, and DOS (stella-1.3-src.tar.gz)
+  * Binary distribution for Windows (stella-1.4-win32.zip)
+
+  * Source code distribution for Linux, Mac OSX and Windows (stella-1.4-src.tar.gz)
+
+  * Source code in SRPM format for Linux RPM-based systems (stella-1.4-1.src.rpm)
 
 PLEASE DO NOT WRITE ASKING FOR ROM IMAGES TO USE WITH STELLA! ALL SUCH
 REQUESTS WILL BE IGNORED!
@@ -37,91 +41,91 @@ REQUESTS WILL BE IGNORED!
 New in this Release
 ===================
 
-  * Improved TIA sound system so that games with digitized audio work
+  * Codebase ported to SDL. The DOS and X11 ports have been discontinued.
 
-  * Added saving and loading of game state to the core; X11, SDL, and DOS
+  * Sound code ported to SDL. For the Linux versions, ALSA and OSS sound
-    versions current support saving and loading game state
+    support has been discontinued.
 
-  * Added support for F4 bankswitching method
+  * The Linux, MacOSX and Windows ports are now based on the same codebase
+    and are actively maintained. That means simultaneous (and hopefully more
+    frequent) releases.
 
-  * Pitfall II DPC sound emulation completed
+  * A new Windows port has been created, with the GUI based on StellaX.
+    This is the first new release for Windows since Stella 1.2.
 
-  * Fixed a bug which caused the difficulty switches to operate backwards
+  * A new Mac OSX port has been created by Mark Grebe. This is the first new
+    release for Mac OSX since Stella 1.2.
 
-  * Changed DPC auto-detection to use file size so that Pitfall II mods work
+  * Added OpenGL rendering support.
 
-  * Modified RIOT timer emulation so that startup values are random
+  * Added more refined in-game GUI.
 
-  * Added 3F bankswitching auto-detection routine so that homebrews and
+  * Added event remapping. Emulation keys can now be remapped to the keyboard
-    demos work without a stella.pro entry
+    or up to 4 joysticks.
 
-  * Updated the TIA message boxes so they look a little nicer
+  * Added native Stelladaptor support. Joysticks, paddles, and driving
+    controllers have been tested.
 
-  * Latest stella.pro file included in distribution
+  * Digital sound support (used in games like Quadrun and Pitfall2) has been
+    greatly improved. Sound generation is now more tightly synchronized with
+    video updates.
 
-  * Added some developer options to the core, and the ability to change game
+  * Added support for switchable palettes. Currently you can switch between
-    width, height, xstart, ystart, and others while the emulation is running.
+    the current Stella palette, original Stella palette (pre-1.2 versions),
-    Added ability to switch between NTSC and PAL at runtime, and the ability
+    and the z26 palette.
-    to save the current properties to a file or to merge the changes into the
-    stella.pro file; X11 and SDL versions supported for now (compile option)
 
-  * External sound server for the X11 and SDL versions no longer required, as
+  * Added support for UA Limited style bankswitching (Funky Fish and Pleiades).
-    all sound code is now integrated into the core
 
-  * Changed locations of the user's config files for the X11 and SDL versions;
+  * Switched to using high compatibility M6502 mode by default. This means
-    the user's stellarc file is now located in $HOME/.stella/stellarc, state
+    old state saves from previous Stella versions will no longer work.
-    files are located in $HOME/.stella/state/ and the stella.pro file is
-    located in $HOME/.stella/stella.pro
 
-  * Changed the way options are supplied on the commandline for the X11 and
+  * The meaning of the "-sound" command line option has been changed. This
-    SDL versions. Now all commandline options take exactly the same arguments
+    option now accepts either 'true' or 'false (1 or 0) to enable/disable
-    as in the INI file.
+    sound.
 
-  * Added "-accurate" command line option to choose between accurate
+  * Changed sound mixer functionality. The system volume/mixer settings will
-    (CPU-intensive) timing or less accurate (CPU-friendly) timing to X11
+    never be changed; volume changes in Stella will only affect the
-    and SDL versions. This is the final version of what was considered
+    emulation itself.
-    experimental timing code in Stella 1.2.
 
-  * Added "-sound" command line option to choose which sound backend to
+  * Added "-video" command line option. This option accepts either 'soft' or
-    use (alsa, oss, sdl) with the X11 and SDL versions.
+    'gl', to use software/OpenGL rendering.
 
-  * Added the developer command line options to the X11 and SDL versions,
+  * Added "-gl_filter" command line option. This option accepts either
-    which are only activated in developer builds: -Dformat, -Dwidth,
+    'nearest' or 'linear', to use GL_NEAREST or GL_LINEAR filtering.
-    -Dheight, -Dxstart, -Dystart, -Dmerge
 
-  * Fixed window resize bug in the X11 port
+  * Added "-gl_aspect" command line option. This option accepts a decimal
+    value specifying how much to scale the width of the emulation image
+    (useful for giving an authentic 'square-looking' 4:3 mode).
 
-  * Added "-nosound" command line option to the DOS port to disable audio
+  * Added "-gl_fsmax" command line option. This option accepts either
+    'true' or 'false, and specifies to use the maximum possible resolution
+    when in fullscreen OpenGL mode (useful for Linux and for Windows on
+    laptops).
 
-  * DOS port supports a "-vsync" option to synchronize emulation with the
+  * Added "-fragsize" command line option. This option accepts the size to
-    video blank of the video card
+    use for sound fragments. Linux/MacOSX works well with 512, Windows seems
+    to need 2048. This value must be a power of two.
 
-  * Changed VGA code in the DOS port to use a 60Hz 320x200 and a 60Hz
+  * Modified "-volume" command line option. If you specify '-1', Stella will
-    320x240 graphics mode
+    use the system volume.
 
-  * DOS port has been updated to run better under Windows NT, 2000, and XP.
+  * Renamed the "-pro" command line option to "-altpro".
-    There are still issues with the sound, however, it is usable.
 
-  * DOS port is using a new Sound Blaster driver created by Matt Conte which
+  * Renamed the "-fps" command line option to "-framerate".
-    supports auto-detection of sound cards.
 
-  * DOS port supports a STELLA_HOME environment variable that defines
+  * Removed the "-center" command line option. Stella now automatically
-    the location of config files.
+    centers the window when possible.
 
-  * In the DOS port the stella.pro file is searched for first in the
+  * Removed the "-paddle real" command line option, since it never really
-    current working director and then in the $STELLA_HOME directory
+    worked correctly (and Stelladaptor support adds that functionality
+    anyway).
 
-  * In the DOS port the ROM image is searched for first using the
+  * Removed all command line options relating to the X11 port
-    specified path, then in $STELLA_HOME/ROMS, and finally in $STELLA_HOME
+    (owncmap, display).
 
 Distribution Site
 ================= 
 
 The Stella distributions can be obtained from the Stella Website at:
 
-  http://stella.atari.org
+  http://stella.sourceforge.net
-
-If for some reason you are unable to connect to the Stella Website using
-the above URL please try http://stella.sourceforge.net.
-
-

stella/Changes.txt

@@ -12,6 +12,90 @@
                                Release History
 ===============================================================================
 
+1.3 to 1.4: (July 17, 2004)
+
+  * Codebase ported to SDL. The DOS and X11 ports have been discontinued.
+
+  * Sound code ported to SDL. For the Linux versions, ALSA and OSS sound
+    support has been discontinued.
+
+  * The Linux, MacOSX and Windows ports are now based on the same codebase
+    and are actively maintained. That means simultaneous (and hopefully more
+    frequent) releases.
+
+  * A new Windows port has been created, with the GUI based on StellaX.
+    This is the first new release for Windows since Stella 1.2.
+
+  * A new Mac OSX port has been created by Mark Grebe. This is the first new
+    release for Mac OSX since Stella 1.2.
+
+  * Added OpenGL rendering support.
+
+  * Added more refined in-game GUI.
+
+  * Added event remapping. Emulation keys can now be remapped to the keyboard
+    or up to 4 joysticks.
+
+  * Added native Stelladaptor support. Joysticks, paddles, and driving
+    controllers have been tested.
+
+  * Digital sound support (used in games like Quadrun and Pitfall2) has been
+    greatly improved. Sound generation is now more tightly synchronized with
+    video updates.
+
+  * Added support for switchable palettes. Currently you can switch between
+    the current Stella palette, original Stella palette (pre-1.2 versions),
+    and the z26 palette.
+
+  * Added support for UA Limited style bankswitching (Funky Fish and Pleiades).
+
+  * Switched to using high compatibility M6502 mode by default. This means
+    old state saves from previous Stella versions will no longer work.
+
+  * The meaning of the "-sound" command line option has been changed. This
+    option now accepts either 'true' or 'false (1 or 0) to enable/disable
+    sound.
+
+  * Changed sound mixer functionality. The system volume/mixer settings will
+    never be changed; volume changes in Stella will only affect the
+    emulation itself.
+
+  * Added "-video" command line option. This option accepts either 'soft' or
+    'gl', to use software/OpenGL rendering.
+
+  * Added "-gl_filter" command line option. This option accepts either
+    'nearest' or 'linear', to use GL_NEAREST or GL_LINEAR filtering.
+
+  * Added "-gl_aspect" command line option. This option accepts a decimal
+    value specifying how much to scale the width of the emulation image
+    (useful for giving an authentic 'square-looking' 4:3 mode).
+
+  * Added "-gl_fsmax" command line option. This option accepts either
+    'true' or 'false, and specifies to use the maximum possible resolution
+    when in fullscreen OpenGL mode (useful for Linux and for Windows on
+    laptops).
+
+  * Added "-fragsize" command line option. This option accepts the size to
+    use for sound fragments. Linux/MacOSX works well with 512, Windows seems
+    to need 2048. This value must be a power of two.
+
+  * Modified "-volume" command line option. If you specify '-1', Stella will
+    use the system volume.
+
+  * Renamed the "-pro" command line option to "-altpro".
+
+  * Renamed the "-fps" command line option to "-framerate".
+
+  * Removed the "-center" command line option. Stella now automatically
+    centers the window when possible.
+
+  * Removed the "-paddle real" command line option, since it never really
+    worked correctly (and Stelladaptor support adds that functionality
+    anyway).
+
+  * Removed all command line options relating to the X11 port
+    (owncmap, display).
+
 1.2 to 1.3: (February 17, 2003)
 
   * Improved TIA sound system so that games with digitized audio work

stella/Readme.txt

@@ -1,14 +1,14 @@
 
-This is release 1.3 of Stella.  Stella is a multi-platform Atari 2600 VCS
+This is release 1.4 of Stella.  Stella is a multi-platform Atari 2600 VCS
 emulator which allows you to play all of your favorite Atari 2600 games
 on your PC.  You'll find the Stella Users Manual in the docs subdirectory.
 If you'd like to verify that you have the latest release of Stella visit
 the Stella Website at:
 
-  http://stella.atari.org
+  http://stella.sourceforge.net
 
 Enjoy,
 
 The Stella Team
-February 17, 2003
+July 17, 2004
 

stella/Todo.txt

@@ -9,11 +9,12 @@
      SSSS     ttt  eeeee llll llll  aaaaa
 
 ===============================================================================
-                         To Do List - November 25, 2003
+                         To Do List - July 17, 2004
 ===============================================================================
 
 If you would like to contribute to Stella's development then find something
-on the list below and send email to Bradford Mott at bwmott@acm.org.
+on the list below and send email to Bradford Mott at bwmott@acm.org or
+Stephen Anthony at stephena@users.sourceforge.net.
 
 For all ports:
 
@@ -27,25 +28,17 @@ For all ports:
     - Mac (680x0, PowerPC)
     - Others...
 
-  * Add a debugger to Stella for game developers
+  * Find people to actually do the above ports, and try to more actively
+    recruit people into the Stella project
+
+  * Add a debugger to Stella for game developers or create an external
+    debugger to be used by Stella and z26 (and add hooks into Stella for it)
 
 
-For the Windows port of Stella (Cyberstella):
+For the Windows GUI frontend (StellaX)
-
-  * More Columns / Advanced sorting for the GUI
 
   * Make all dialog boxes resizable for any size text
 
-  * Improve the DirectSound support
-
-  * Add Fullscreen / Windowed mode - Alt-Enter
-
-  * Add a Direct3D version, so we have alpha-blending, hardware stretch, etc.
-
-  * Add commandline options that were in StellaX
-
-  * Add Screenshots in PNG format - F12
-
   * The following features depend on developer availability
 
     - Add a Sprite/Animation Editor 

stella/docs/stella.html

@@ -394,14 +394,14 @@
 				<pre>   cp stella.pro /etc</pre> or to your home directory:
 				<pre>   mkdir ~/.stella<br>   cp stella.pro ~/.stella</pre></li>
 		</ol>
-		<li><b>Source RPM</b> (stella-<i>release</i>.src.rpm)</li>
+		<li><b>Source RPM</b> (stella-<i>release</i>-1.src.rpm)</li>
 		<ol>
 			<li>Rebuild the archive with the following command:
 				<pre>   rpmbuild --rebuild stella-<i>release</i>.src.rpm</pre></li>
 			<li>Follow the instructions under <i>Binary RPM</i> to install
 				the stella-<i>release</i>.ix86.rpm file</li>
 		</ol>
-		<li><b>Binary RPM</b> (stella-<i>release</i>.ix86.rpm)</li>
+		<li><b>Binary RPM</b> (stella-<i>release</i>-1.ix86.rpm)</li>
 		<ol>
 			<li>Install the binary RPM with the following command:
 				<pre>   rpm -Uvh stella-<i>release</i>.ix86.rpm</pre></li>