emu/debug: Extended memory commands for region and space

docs/source/debugger/index.rst

@@ -158,6 +158,10 @@ Examples:
     Address 9660 in the default address space of the device with the
     absolute tag ``:ram``, or the ``ram`` space of the root machine
     device.
+``1883:vram.m``
+    Address 1883 in the memory region with the absolute tag ``:vram``.
+``1923:sprites.s``
+    Address 1923 in the memory share with the absolute tag ``:sprites``.
 
 The examples here include a lot of corner cases, but in general the
 debugger should take the most likely meaning for a device or address
@@ -327,6 +331,7 @@ The size may optionally be preceded by an access type specification:
 * ``o`` specifies direct read/write pointer access defaulting to space 3
   (opcodes)
 * ``m`` specifies a memory region
+* ``s`` specifies a memory share
 
 Finally, this may be preceded by a tag and/or address space name
 followed by a dot (``.``).

docs/source/debugger/memory.rst

@@ -65,6 +65,7 @@ find
 ----
 
 **f[ind][{d|i|o}] <address>[:<space>],<length>[,<data>[,…]]**
+**f[ind] <address>:<memory>.{m|s},<length>[,<data>[,…]]**
 
 Search through memory for the specified sequence of data.  The
 **<address>** is the address to begin searching from, optionally
@@ -114,6 +115,7 @@ fill
 ----
 
 **fill[{d|i|o}] <address>[:<space>],<length>[,<data>[,…]]**
+**fill <address>:<memory>.{m|s},<length>[,<data>[,…]]**
 
 Overwrite a block of memory with copies of the supplied data sequence.
 The **<address>** specifies the address to begin writing at, optionally
@@ -146,6 +148,7 @@ dump
 ----
 
 **dump[{d|i|o}] <filename>,<address>[:<space>],<length>[,<group>[,<ascii>[,<rowsize>]]]**
+**dump <filename>,<address>:<memory>.{m|s},<length>[,<group>[,<ascii>[,<rowsize>]]]**
 
 Dump memory to the text file specified by the **<filename>** parameter.
 The **<address>** specifies the address to start dumping from,
@@ -190,6 +193,7 @@ strdump
 -------
 
 **strdump[{d|i|o}] <filename>,<address>[:<space>],<length>[,<term>]**
+**strdump <filename>,<address>:<memory>.{m|s},<length>[,<term>]**
 
 Dump memory to the text file specified by the **<filename>** parameter.
 The **<address>** specifies the address to start dumping from,
@@ -216,6 +220,7 @@ save
 ----
 
 **save[{d|i|o}] <filename>,<address>[:<space>],<length>**
+**save <filename>,<address>:<memory>.{m|s},<length>**
 
 Save raw memory to the binary file specified by the **<filename>**
 parameter.  The **<address>** specifies the address to start saving
@@ -260,6 +265,9 @@ start saving from, and the **<length>** specifies how much memory to
 save.  The range **<address>** through **<address>+<length>-1**,
 inclusive, will be output to the file.
 
+Alternetevely use :ref:`debugger-command-save` syntax:
+``save <filename>,<address>:<region>.m,<length>``
+
 Examples:
 
 ``saver data.bin,200,100,:monitor``
@@ -278,6 +286,7 @@ load
 ----
 
 **load[{d|i|o}] <filename>,<address>[:<space>][,<length>]**
+**load <filename>,<address>:<memory>.{m|s}[,<length>]**
 
 Load raw memory from the binary file specified by the **<filename>**
 parameter.  The **<address>** specifies the address to start loading to,
@@ -334,6 +343,9 @@ through **<address>+<length>-1**, inclusive, will be read in from the
 file.  If the **<length>** is zero, or is greater than the total length
 of the file, the entire contents of the file will be loaded but no more.
 
+Alternetevely use :ref:`debugger-command-load` syntax:
+``load <filename>,<address>:<region>.m[,<length>]``
+
 Examples:
 
 ``loadr data.bin,200,100,:monitor``