doc updates

* List agents in markdown
* Add another 9.6.2 change to release notes
* Fix date in user readme

SoarShuffler/Soar_Projects_Filelist.txt

@@ -339,7 +339,7 @@ SoarTutorial_$VERSION
   $COMPILE_DIR/tcl=bin/tcl
   $SOAR_GROUP_REPOS_HOME/Release-Support/txt/README=$ROOT
   $SOAR_GROUP_REPOS_HOME/Release-Support/txt/license.txt=$ROOT
-  $SOAR_GROUP_REPOS_HOME/Release-Support/txt/Agents_readme.txt=Agents/
+  $SOAR_GROUP_REPOS_HOME/Release-Support/txt/Agents_readme.md=Agents/
   $SOAR_GROUP_REPOS_HOME/Release-Support/pdf/Soar Tutorial Part 1 - Simple Agents.pdf=Tutorial
   $SOAR_GROUP_REPOS_HOME/Release-Support/pdf/Soar Tutorial Part 2 - Interacting with an Environment.pdf=Tutorial
   $SOAR_GROUP_REPOS_HOME/Release-Support/pdf/Soar Tutorial Part 3 - Subgoals.pdf=Tutorial

txt/Agents_readme.md

@@ -0,0 +1,63 @@
+# Soar 9.6 Demo Agents, April 2017
+
+Classic AI problems implemented for Soar 9
+
+## Arithmetic
+
+* Does multicolumn addition and subtraction using simple
+* addition facts. Automatically generates, solves, and verifies
+* 1000 problems. Demonstrates hierarchical task decomposition
+* and chunking over the decomposition.
+
+## Blocks-World: Stack blocks
+
+* Demonstrates means-ends analysis, operator-subgoaling, and look-ahead
+
+## Eight-Puzzle: Sliding tile puzzle
+
+* Demonstrates look-ahead search and chunking.
+* Has graphical interface
+
+## EpMem-Tutorial
+
+* A simple agent that shows how structures are stored in episodic
+* memory and then retrieved.
+
+## Hello-world
+
+* The simplest example of Soar rules and operators
+
+## Left-right
+
+* Trivial example for RL.
+
+## MAC: Missionaries and Cannibals
+
+* Has multiple version using look-ahead search
+* and chunking showing tradeoffs in state representations for
+* operator application vs. state copying.
+
+## Towers-of-hanoi: Classic disk and peg problem
+
+* Two strategies implemented - no search or learning.
+* Multiple implementations of one of the strategies using
+* different representations with different generality and different
+* execution costs
+
+## SMem-Tutorial
+
+* A simple agent that shows how structures are stored in semantic
+* memory and then retrieved.
+
+## Water-jug
+
+* Has two versions which use look-ahead search
+* and chunking showing tradeoffs in state representations for
+* operator application vs. state copying.
+* Another version with simple evaluation in tie subgoal (water-jug-tie)
+* water-jug-rl works with RL.
+
+## Default
+
+* Holds rules used for implementing common problem solving
+* strategies including look-ahead search and operator subgoaling.

txt/README

@@ -1,9 +1,9 @@
 =========================
-=    Soar 9.6.1 README  =
-=      January  2023    =
+=    Soar 9.6.2 README  =
+=      September  2023    =
 =========================
 
-Welcome to Soar!  Soar 9.6.1 is the current, stable version of Soar. It is a maintenance release, meaning no major features were added, but it does still represent a lot of work in the form of bug fixes, code modernization, and usability improvements. Note that the included Java tools, such as the Soar Java Debugger, now require at least Java 11 to run.
+Welcome to Soar!  Soar 9.6.2 is the current, stable version of Soar. It is a maintenance release, meaning no major features were added, but it does still represent a lot of work in the form of bug fixes, code modernization, and usability improvements. Note that the included Java tools, such as the Soar Java Debugger, now require at least Java 11 to run.
 
 * VisualSoar has been updated with support for all Soar commands and subsytems, improved reliability and usability, and lots of bug fixes.
 
@@ -23,7 +23,7 @@ The full release notes can be found in its own file.
 Official Soar Manual
 ====================
 
-The 9.6.1 edition of the Soar Manual is included here for your reference. However, the manual is continually updated, and the latest version can be
+The 9.6.2 edition of the Soar Manual is included here for your reference. However, the manual is continually updated, and the latest version can be
 found at:
 
 https://soar.eecs.umich.edu/downloads/SoarManual.pdf

txt/Release_Notes_9.6.2.txt

@@ -32,6 +32,12 @@ New Features
     will no longer need to pass the class instance separately as (void*)userData, and can
     instead simply pass in the result of std::bind.
 
+() More output filtering options in the debugger
+    We rename "hide all" to "show only errors and top-level", then add a true "hide
+    all" filter to complement that. We also separate messages from RHS writes, and add
+    additional filter options for error and top-level. This covers all 14 output
+    types, while still providing convenient checkboxes for common settings.
+
 () Better dark mode styling for the debugger
     Previous versions of the debugger were very difficult to read on Mac in dark mode due
     to displaying black text on a dark background. The text now correctly shows as white.