Started documentation updates for the next release. All the changes

haven't been made yet, but they will be soon enough.


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

Announce.txt

@@ -9,7 +9,7 @@
      SSSS     ttt  eeeee llll llll  aaaaa
 
 ===========================================================================
-                 Release 3.2 for Linux, MacOSX and Windows
+                Release 3.3 for Linux, MacOSX and Windows
 ===========================================================================
 
 The Atari 2600 Video Computer System (VCS), introduced in 1977, was the
@@ -21,30 +21,31 @@ all of your favourite 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 and is currently maintained by Stephen Anthony.
 
-This is the 3.2 release of Stella for Linux, Mac OSX and Windows.  The
+This is the 3.3 release of Stella for Linux, Mac OSX and Windows.  The
 distributions currently available are:
 
-  * Binary installer (exe) for Windows 32-bit & 64-bit :
-      Stella-3.2-win32.exe
-      Stella-3.2-x64.exe
+  * Binaries for Windows XP/Vista/7 :
+      Stella-3.3-win32.exe   (32-bit EXE installer)
+      Stella-3.3-x64.exe     (64-bit EXE installer)
+      Stella-3.3-windows.zip (32/64 bit versions)
 
-  * Binary zip for Windows, containing 32 and 64-bit versions :
-      Stella-3.2-windows.zip
+  * Binaries for Windows 98/2000 :
+      Stella-3.3_98_2k-windows.zip (32-bit for Windows 98/2000)
 
   * Binary distribution for MacOSX 32-bit & 64-bit :
-      Stella-3.2-macosx.dmg (32-bit Universal Binary)
-      Stella-3.2_intel_10.6-macosx.dmg (32/64-bit Intel/Snow-Leopard only)
+      Stella-3.3-macosx.dmg (32-bit Universal Binary)
+      Stella-3.3_intel_10.6-macosx.dmg (32/64-bit Intel/Snow-Leopard only)
 
   * Binary distribution in 32-bit & 64-bit Ubuntu DEB format :
-      stella_3.2-1_i386.deb
-      stella_3.2-1_amd64.deb
+      stella_3.3-1_i386.deb
+      stella_3.3-1_amd64.deb
 
   * Binary distribution in 32-bit & 64-bit RPM format :
-      stella-3.2-2.i386.rpm
-      stella-3.2-2.x86_64.rpm
+      stella-3.3-2.i386.rpm
+      stella-3.3-2.x86_64.rpm
 
   * Source code distribution for all platforms :
-      stella-3.2-src.tar.gz
+      stella-3.3-src.tar.gz
 
 PLEASE DO NOT WRITE ASKING FOR ROM IMAGES TO USE WITH STELLA! ALL SUCH
 REQUESTS WILL BE IGNORED!

Changes.txt

@@ -12,13 +12,86 @@
                                Release History
 ===========================================================================
 
+3.2.2 to 3.3: (November xx, 2010)
+
+  * Added the following Distella 'directives', which are used to override
+    and specifically tell the debugger how to treat address space (SKIP,
+    CODE, GFX, PGFX, DATA, ROW).  See the debugger documentation for more
+    information.
+
+  * Disassembly from the debugger is now tracked by the emulation core,
+    and accented by the built-in Distella code.  Basically, the emulation
+    core knows when an address is referenced as code, making for very
+    accurate disassembled output.  Related to this, the emulation core now
+    tracks accesses to GRPx and PFx registers, automatically marking the
+    addresses as GFX or PGFX sections.  Most bankswitch schemes have been
+    modified for this functionality, except for 3E, 4A50, AR, FE and MC.
+
+  * Improved output of graphics output in the disassembler, by marking
+    such addresses with a bitmap of the data they represent.  This
+    allows player graphics (GFX directive) and playfield graphics (PGFX
+    directive) to really stand out in the disassembly.  Related to this,
+    added ability to edit such graphics in either binary or hexidecimal.
+
+  * Added preliminary support for Distella configuration files.  Much
+    more work is required in this area, since Stella now contains
+    directives that don't yet exist in the standalone Distella program.
+    Configuration files are automatically loaded, and debugger commands
+    now exist to load and save configuration directives directly from
+    the debugger.
+
+  * Added 'data source' address output for the CPU A/X/Y registers.  This
+    is useful for quickly seeing what an operand address resolves into
+    with an LDx command.
+
+  * Many commands in the debugger prompt are now case-insensitive;
+    further improvements will be made in a future release.
+
+  * Many improvements to the built-in Distella disassembler.  When passing
+    a relative branch or jump, data is now disassembled as code only if
+    the emulation core hasn't detected it as data.  Such 'preliminary'
+    code is marked with a '*' in the disassembler, indicating that it is
+    tentative code, and hasn't actually been executed yet.  This allows to
+    quickly see possible code paths, and at the same time eliminate
+    disassembly of addresses that are never used as code sections.
+
+  * Program counter/instruction addresses can now be toggled in the
+    disassembly.
+
+  * Fixed bug in several text input fields, whereby binary data couldn't
+    be input (a '\' was required, but the character was blocked).
+
+  * Fixed issues with PAL ROMs on screenmodes smaller than a PAL ROM
+    would require.  In this case, the image is centered and clipped to
+    the screen resolution.  This prevents the message "PAL ROM not
+    supported" from appearing.
+
+  * Fixed bug in fullscreen OpenGL mode when using ATI video cards;
+    the desktop background was 'bleeding through', resulting in a very
+    annoying flickering.
+
+  * Application window centering now also works when switching between
+    video modes, not just when starting the application.
+
+  * Added support for building a Windows version compatible with Windows
+    98 and 2000 (compiled with Visual Studio 2005).
+
+  * Fixed build issues for Innosetup in Windows XP.
+
+  * Fixed bug in OSX version where the name of the application wasn't
+    being shown in Activity Monitor.
+
+  * State files from older versions will no longer work in this release,
+    because of the extensive changes to the debugger and disassembler.
+
+-Have fun!
+
+
 3.2.1 to 3.2.2: (September 17, 2010)
 
   * Fixed bug with window centering; if enabled and the the window was
     larger than the desktop, the window would be moved offscreen.
 
--Have fun!
-
 
 3.2 to 3.2.1: (August 25, 2010)
 

Readme.txt

@@ -1,4 +1,4 @@
-This is release 3.2.1 of Stella.  Stella is a multi-platform Atari 2600 VCS
+This is release 3.3 of Stella.  Stella is a multi-platform Atari 2600 VCS
 emulator which allows you to play all of your favourite 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
@@ -9,4 +9,4 @@ the Stella Website at:
 Enjoy,
 
 The Stella Team
-August 25, 2010
+November xx, 2010

debian/changelog

@@ -1,3 +1,10 @@
+stella (3.3-1) stable; urgency=high
+
+  * Version 3.3 release
+
+ -- Stephen Anthony <stephena@users.sf.net>  Wed, 25 Aug 2010 18:38:25 +0200
+
+
 stella (3.2.1-1) stable; urgency=high
 
   * Version 3.2.1 release

docs/index.html

@@ -10,7 +10,7 @@
   <br><br>
   <center><h2><b>A multi-platform Atari 2600 VCS emulator</b></h2></center>
 
-  <center><h4><b>Release 3.2.1</b></h4></center>
+  <center><h4><b>Release 3.3</b></h4></center>
   <br><br>
 
   <center><h2><b>User's Guide</b></h2></center>