Final doc updates before the 2.4 release. I plan to spend the next day or two

doing some final testing, with the release coming on Monday, Aug. 20.


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

stella/Announce.txt

@@ -9,7 +9,7 @@
      SSSS     ttt  eeeee llll llll  aaaaa
 
 ===============================================================================
-                  Release 2.3.5 for Linux, Mac OSX and Windows
+                  Release 2.4 for Linux, Mac OSX and Windows
 ===============================================================================
 
 The Atari 2600 Video Computer System (VCS), introduced in 1977, was the most 
@@ -21,23 +21,21 @@ 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 2.3.5 release of Stella for Linux, Mac OSX, Windows and GP2X.
+This is the 2.4 release of Stella for Linux, Mac OSX, Windows and GP2X.
 Distributions for other operating systems will appear as they become available.
 The distributions currently available are:
 
-  * Binary distribution in RPM format for Linux (stella-2.3.5-1.i586.rpm)
+  * Binary distribution in RPM format for Linux (stella-2.4-1.i586.rpm)
 
-  * Binary distribution for Mac OSX (StellaOSX2.3.5.dmg.gz)
+  * Binary distribution for Mac OSX (StellaOSX2.4.dmg.gz)
 
-  * Binary installer (exe) for Windows (stella-2.3.5-win32.exe)
+  * Binary installer (exe) for Windows (stella-2.4-win32.exe)
 
-  * Binary zip for Windows (stella-2.3.5-win32.zip)
+  * Binary zip for Windows (stella-2.4-win32.zip)
 
-  * Binary zip for GP2X (stella-2.3.5-gp2x.zip)
+  * Source code in SRPM format for Linux RPM-based systems (stella-2.4-1.src.rpm)
 
-  * Source code in SRPM format for Linux RPM-based systems (stella-2.3.5-1.src.rpm)
+  * Source code distribution for all platforms (stella-2.4-src.tar.gz)
-
-  * Source code distribution for all platforms (stella-2.3.5-src.tar.gz)
 
 PLEASE DO NOT WRITE ASKING FOR ROM IMAGES TO USE WITH STELLA! ALL SUCH
 REQUESTS WILL BE IGNORED!

stella/Changes.txt

@@ -12,6 +12,69 @@
                                Release History
 ===============================================================================
 
+2.3.5 to 2.4: (August 20, 2007)
+
+  * Added new video sub-system where fullscreen and windowed modes are treated
+    differently.  Windowed modes now use '-zoom_tia' and '-zoom_ui' arguments,
+    while fullscreen modes can be specified by resolution using the new
+    '-fullres' argument.
+
+  * Widescreen video modes are now supported; Stella will simply center the
+    image with surrounding black borders.
+
+  * Many UI-related changes, including resizable ROM launcher and debugger
+    windows, and a new UI palette (the previous 'classic' palette is still
+    available).  This is still a work in progress.
+
+  * The locations of all major config files (statedir, palette file,
+    cheat file, properties file, etc) are now configurable from the
+    commandline and within the UI.
+
+  * Updates to TIA palette support.  Added SECAM support, and removed the
+    built-in 'original' palette.  Standard, z26, and user are still
+    available.
+
+  * Various bugfixes to some debugger commands.  The 'run' command no
+    longer causes a crash, and several others have better error-checking.
+
+  * Added more complete cartridge auto-detection for Commavid (CV), 3E,
+    3F and Activision (FE) formats.
+
+  * Removed XStart and Width ROM properties, since the forthcoming TIA
+    rework won't be using them.
+
+  * Reworked internal storage of ROM properties to be faster and take up
+    less space.
+
+  * Added several different ways of stretching the OpenGL image to the
+    '-gl_fsmax' argument, for more flexibility.
+
+  * Removed OpenGL aspect ratio setting favour of the previously mentioned
+    video changes.  We'll see how this goes.
+
+  * Removed dirty-rect support from software rendering, since it was actually
+    sub-optimal in Windows and OSX and defaulted to off in previous versions.
+
+  * Added support for gzipped ROMs.
+
+  * Re-added pause support.
+
+  * Re-added support for Windows 98.
+
+  * Removed support for 'STELLA_BASEDIR' environment variable, since each
+    config file can be now configured separately.
+
+  * Removed '-fastscbios' argument, since it must always be turned on.
+
+  * Removed PSP support, since it hasn't been updated in over a year, and
+    someone else is maintaining another port elsewhere.
+
+  * For the Unix/Linux port; fixed 'make install' issues, and changed icon to
+    PNG format.
+
+Have fun!
+
+
 2.3 to 2.3.5: (January 17, 2007)
 
   * Greatly improved cartridge bankswitch type auto-detection.  Stella
@@ -72,8 +135,6 @@
 
   * For the GP2X port; added vertical centering of the TIA image (when possible).
 
-Have fun!
-
 
 2.2 to 2.3: (December 22, 2006)
 

stella/Readme.txt

@@ -1,5 +1,5 @@
 
-This is release 2.3.5 of Stella.  Stella is a multi-platform Atari 2600 VCS
+This is release 2.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
@@ -10,4 +10,4 @@ the Stella Website at:
 Enjoy,
 
 The Stella Team
-January 17, 2007
+August 20, 2007

stella/docs/index.html

@@ -221,8 +221,63 @@
 	<h2><b>New in Release 2.4</b></h2>
 
 	<ul>
+<li>Added new video sub-system where fullscreen and windowed modes are treated
+    differently.  Windowed modes now use '-zoom_tia' and '-zoom_ui' arguments,
+    while fullscreen modes can be specified by resolution using the new
+    '-fullres' argument.</li>
 
+<li>Widescreen video modes are now supported; Stella will simply center the
+    image with surrounding black borders.</li>
 
+<li>Many UI-related changes, including resizable ROM launcher and debugger
+    windows, and a new UI palette (the previous 'classic' palette is still
+    available).  This is still a work in progress.</li>
+
+<li>The locations of all major config files (statedir, palette file,
+    cheat file, properties file, etc) are now configurable from the
+    commandline and within the UI.</li>
+
+<li>Updates to TIA palette support.  Added SECAM support, and removed the
+    built-in 'original' palette.  Standard, z26, and user are still
+    available.</li>
+
+<li>Various bugfixes to some debugger commands.  The 'run' command no
+    longer causes a crash, and several others have better error-checking.</li>
+
+<li>Added more complete cartridge auto-detection for Commavid (CV), 3E,
+    3F and Activision (FE) formats.</li>
+
+<li>Removed XStart and Width ROM properties, since the forthcoming TIA
+    rework won't be using them.</li>
+
+<li>Reworked internal storage of ROM properties to be faster and take up
+    less space.</li>
+
+<li>Added several different ways of stretching the OpenGL image to the
+    '-gl_fsmax' argument, for more flexibility.</li>
+
+<li>Removed OpenGL aspect ratio setting favour of the previously mentioned
+    video changes.  We'll see how this goes.</li>
+
+<li>Removed dirty-rect support from software rendering, since it was actually
+    sub-optimal in Windows and OSX and defaulted to off in previous versions.</li>
+
+<li>Added support for gzipped ROMs.</li>
+
+<li>Re-added pause support.</li>
+
+<li>Re-added support for Windows 98.</li>
+
+<li>Removed support for 'STELLA_BASEDIR' environment variable, since each
+    config file can be now configured separately.</li>
+
+<li>Removed '-fastscbios' argument, since it must always be turned on.</li>
+
+<li>Removed PSP support, since it hasn't been updated in over a year, and
+    someone else is maintaining another port elsewhere.</li>
+
+<li>For the Unix/Linux port; fixed 'make install' issues, and changed icon to
+    PNG format.</li>
 	</ul>
 
 	<p>

stella/src/unix/stella.SlackBuild

@@ -1,6 +1,6 @@
 #!/bin/sh
 
-# $Id: stella.SlackBuild,v 1.6 2006-12-20 12:42:56 stephena Exp $
+# $Id: stella.SlackBuild,v 1.7 2007-08-17 17:11:43 stephena Exp $
 
 # stella.SlackBuild for Stella 2.x, B. Watson, 2005
 
@@ -13,7 +13,7 @@ die() {
 	exit 1
 }
 
-VERSION=2.3
+VERSION=2.4
 ARCH=${ARCH-i486}
 BUILD=1
 

stella/src/unix/stella.spec

@@ -1,5 +1,5 @@
 %define name    stella
-%define version 2.3
+%define version 2.4
 %define rel     1
 
 %define build_plf 0

stella/src/win32/stella.iss

@@ -3,14 +3,14 @@
 
 [Setup]
 AppName=Stella
-AppVerName=Stella 2.3.5
+AppVerName=Stella 2.4
 AppPublisher=Bradford W. Mott and the Stella team
 AppPublisherURL=http://stella.sourceforge.net
 AppSupportURL=http://stella.sourceforge.net
 AppUpdatesURL=http://stella.sourceforge.net
 DefaultDirName={pf}\Stella
 DefaultGroupName=Stella
-OutputBaseFilename=stella-2.3.5-win32
+OutputBaseFilename=stella-2.4-win32
 Compression=lzma
 SolidCompression=yes
 
@@ -21,10 +21,10 @@ Name: "eng"; MessagesFile: "compiler:Default.isl"
 Name: "desktopicon"; Description: "{cm:CreateDesktopIcon}"; GroupDescription: "{cm:AdditionalIcons}"; Flags: unchecked
 
 [Files]
-Source: "H:\windows\src\stella\stella-2.3.5\stella.exe"; DestDir: "{app}"; Flags: ignoreversion
+Source: "H:\windows\src\stella\stella-2.4\stella.exe"; DestDir: "{app}"; Flags: ignoreversion
-Source: "H:\windows\src\stella\stella-2.3.5\zlib1.dll"; DestDir: "{app}"; Flags: ignoreversion
+Source: "H:\windows\src\stella\stella-2.4\zlib1.dll"; DestDir: "{app}"; Flags: ignoreversion
-Source: "H:\windows\src\stella\stella-2.3.5\SDL.dll"; DestDir: "{app}"; Flags: ignoreversion
+Source: "H:\windows\src\stella\stella-2.4\SDL.dll"; DestDir: "{app}"; Flags: ignoreversion
-Source: "H:\windows\src\stella\stella-2.3.5\docs\*"; DestDir: "{app}\docs"; Flags: ignoreversion recursesubdirs createallsubdirs
+Source: "H:\windows\src\stella\stella-2.4\docs\*"; DestDir: "{app}\docs"; Flags: ignoreversion recursesubdirs createallsubdirs
 ; NOTE: Don't use "Flags: ignoreversion" on any shared system files
 
 [Icons]