Get ready for release 1.4.0

Author: rocky

NEWS.md

@@ -1,3 +1,12 @@
+1.4.0 2025-07-26
+================
+
+* Adjust for changes in the Python 3.13 for debugging, and breakage caused by Python 3.13 and its packaging system.
+* Environment variable `TREPAN_PYGMENTS_STYLE` now influences the default style used. This is useful in when going from a shell using Pygments goes into the debugger. In particular, the Mathics3 debugger and ``mathicsscript`` work this way.
+* Add set/show disasmflavor to set disassembly style. "Disasmflavor" is the name `gdb` uses.
+* Improve `run_eval()` based on use.
+* Go over docs, and README.rst
+
 1.3.1 2025-01-16
 ================
 

docs/syntax/command.rst

@@ -4,8 +4,8 @@ Debugger Command Syntax
 =======================
 
 Command names and arguments are separated with spaces like POSIX shell
-syntax. Parentheses around the arguments and commas between them are
-not used. If the first non-blank character of a line starts with ``#``,
+syntax. Parenthesis around the arguments and commas between them are
+not used. If the first non-blank character of a line starts with `#`,
 the command is ignored.
 
 Commands are split at wherever ``;;`` appears. This process disregards
@@ -21,7 +21,7 @@ Resolving a command name involves possibly 4 steps. Some steps may be
 omitted depending on early success or some debugger settings:
 
 1. The leading token is first looked up in the macro table. If it is in the table, the expansion replaces the current command and
-possibly other commands pushed onto a command queue. Run `help macros` for
+possibly other commands pushed onto a command queue. See `help macros` for
 help on how to define macros, and `info macro` for current macro
 definitions.
 
@@ -39,9 +39,9 @@ program at the point it is stopped. However, this is done only if
 
 If :ref:`auto eval <set_autoeval>` is not set on, or if running the Python statement produces an error, we display an error message that the entered string is "undefined".
 
-If you want a python-, ipython-, or bpython-like shell
-command-processing, it's possible to go into a Python shell with the
-corresponding command. It is also possible to arrange to go into a Python shell every time you enter the debugger.
+If you want python-, ipython-, or bpython-like shell
+command-processing, it's possible to go into a ``python`` shell with the
+corresponding command. It is also possible to arrange to go into a ``python`` shell every time you enter the debugger.
 
 .. seealso::
 

trepan/processor/command/help/arange.rst

@@ -13,7 +13,7 @@ An address range is in one of the following forms:
 
 A *location* is described elsewhere. *first* and *last* can also be
 linespecs but they also may be a number or address (bytecode
-offset). And finally *last* can be an (line number) offset.
+offset). And finally *last* can be a (line number) offset.
 
 A number is just a decimal number. An offset is a number prefaced with "+" and
 indicates the number to increment the line number found in *first*.
@@ -23,7 +23,7 @@ Examples
 
 ::
 
-  *5                 # start from bytecode offset 5 of current file
+  *5                   # start from bytecode offset 5 of the current file
   *5 ,                 # Same as above.
   foo.py:*5            # start from bytecode offset 5 of file foo.py
 

trepan/processor/command/help/command.rst

@@ -21,32 +21,32 @@ Resolving a command name involves possibly 4 steps. Some steps may be
 omitted depending on early success or some debugger settings:
 
 1. The leading token is first looked up in the macro table. If it is in
-the table, the expansion is replaces the current command and possibly
+the table, the expansion replaces the current command and possibly
 other commands pushed onto a command queue. See `help macros` for
 help on how to define macros, and `info macro` for current macro
 definitions.
 
-2. The leading token is next looked up in the debugger alias table and
+2. The leading token is next looked up in the debugger alias table, and
 the name may be substituted there. See "help alias" for how to define
 aliases, and "show alias" for the current list of aliases.
 
-3. After the above, The leading token is looked up a table of debugger
+3. After the above, the leading token is looked up in a table of debugger
 commands. If an exact match is found, the command name and arguments
 are dispatched to that command.
 
 4. If after all of the above, we still don't find a command, the line
 may be evaluated as a Python statement in the current context of the
-program at the point it is stopped. However this is done only if
+program at the point it is stopped. However, this is done only if
 "auto evaluation" is on.  It is on by default.
 
 If `auto eval` is not set on, or if running the Python statement
 produces an error, we display an error message that the entered string
 is "undefined".
 
 If you want python-, ipython- or bpython-like shell
-command-processing, it's possible to go into an python shell with the
-corresponding command. It is also possible to arrange going into an
-python shell every time you enter the debugger.
+command-processing, it's possible to go into a ``python`` shell with the
+corresponding command. It is also possible to arrange going into a
+``python`` shell every time you enter the debugger.
 
 See also:
 ---------

trepan/version.py

@@ -5,4 +5,4 @@
 # debugger version number.
 
 # fmt: off
-__version__="1.3.2.dev0"  # noqa
+__version__="1.4.0"  # noqa