[PATCH]: aa6a5ed77 doc: Updated cmds "riscv set_prefer_sba" and "riscv set_mem_access"

[gerrit]

This is an automated email from Gerrit.

"Jan Matyas <mat...@codasip.com>" just uploaded a new patch set to Gerrit, 
which you can find at https://review.openocd.org/c/openocd/+/6743

-- gerrit

commit aa6a5ed770840bb743ab2c4b4d76283570697153
Author: Jan Matyas <mat...@codasip.com>
Date:   Mon Nov 22 14:50:30 2021 +0100

    doc: Updated cmds "riscv set_prefer_sba" and "riscv set_mem_access"
    
    Updated the documentation for the two RISC-V target commands:
    - "riscv set_prefer_sba" - marked as deprecated, superseded
      by the latter
    - "riscv set_mem_access" - new command, new entry into the doc
    
    The implementation of these commands is already merged, so this
    change just makes the corresponding update to the doc.
    
    Change-Id: I3c07672cde94324407cf667504dba5402f63a543
    Signed-off-by: Jan Matyas <mat...@codasip.com>

diff --git a/doc/openocd.texi b/doc/openocd.texi
index 85dc432da..ebab5dbc7 100644
--- a/doc/openocd.texi
+++ b/doc/openocd.texi
@@ -10205,8 +10205,32 @@ This is used to access 64-bit floating point registers 
on 32-bit targets.
 @end deffn
 
 @deffn {Command} {riscv set_prefer_sba} on|off
-When on, prefer to use System Bus Access to access memory.  When off (default),
-prefer to use the Program Buffer to access memory.
+This command is @emph{deprecated}. Please use @command{riscv set_mem_access} 
instead.
+
+@itemize
+@item @command{riscv set_prefer_sba off} is equivalent to
+      @command{riscv set_mem_access progbuf sysbus abstract}.
+@item @command{riscv set_prefer_sba on} is equivalent to
+      @command{riscv set_mem_access sysbus progbuf abstract}.
+@end itemize
+@end deffn
+
+@deffn Command {riscv set_mem_access} method1 [method2] [method3]
+Specify which RISC-V memory access method(s) shall be used, and in which order
+of priority. At least one method must be specified.
+
+Available methods are:
+@itemize
+@item @code{progbuf} - Use RISC-V Debug Program Buffer to access memory.
+@item @code{sysbus} - Access memory via RISC-V Debug System Bus interface.
+@item @code{abstract} - Access memory via RISC-V Debug abstract commands.
+@end itemize
+
+By default, all memory access methods enabled in the following order:
+@code{progbuf sysbus abstract}.
+
+This command can be used to change the memory access methods if the default
+behavior is not suitable for a particular target.
 @end deffn
 
 @deffn {Command} {riscv set_enable_virtual} on|off

--