riscv-openocd/doc/manual
Antonio Borneo e680841fd2 helper/command: pass command arguments also as Jim_Obj
Some OpenOCD command gets fragment of TCL scripts as command-line
argument, fragments that will be kept and executed later on.
E.g. the command 'configure' gets the body of an OpenOCD event:
	$TARGET configure -event halted {TCL code}

These commands store the argument as a Jim_Obj and pass it to the
jimtcl interpreter when the TCL fragment has to be executed.
Using Jim_Obj as storage is relevant to let the jimtcl interpreter
to recover extra info of the TCL fragment, like the file-name and
the line-number that contain the fragment, that will be printed
out in case of run-time errors.

While converting the commands to COMMAND_HANDLER, we should avoid
storing the argument as C strings otherwise we will loose precious
info in case of run-time errors making challenging the debugging
of such TCL fragments.

Extend the struct command_invocation to contain the array that
points to the Jim_Obj of the command arguments.
This will be used while converting commands to COMMAND_HANDLER.

Change-Id: If37c5f20e9a71349f77ba1571baf1e6778e28aa5
Signed-off-by: Antonio Borneo <borneo.antonio@gmail.com>
Reviewed-on: https://review.openocd.org/c/openocd/+/8057
Tested-by: jenkins
2024-01-13 14:44:32 +00:00
..
images doxygen: use inline jtag state maching image 2013-07-01 08:50:31 +00:00
jtag/drivers remote_bitbang: add use_remote_sleep option to send delays to remote 2023-12-16 07:55:38 +00:00
primer doc: use the new jimtcl syntax for 'expr' 2022-01-22 10:13:36 +00:00
target doc/target/mips: fix grammar 2020-07-26 20:08:48 +01:00
app.txt Commit skeleton files for high-level developer manual using doxygen. 2009-05-13 08:58:08 +00:00
endianness.txt doc: how to use QEMU to test big-endian build 2022-08-27 16:18:17 +00:00
flash.txt Remove annoying end-of-line whitespace from doc/* files. 2009-09-21 18:52:45 +00:00
helper.txt helper/command: pass command arguments also as Jim_Obj 2024-01-13 14:44:32 +00:00
jtag.txt zy1000: drop the code, deprecated in v0.10.0 2021-03-19 21:55:50 +00:00
main.txt doc: how to use QEMU to test big-endian build 2022-08-27 16:18:17 +00:00
release.txt doc: remove duplicated words 2020-07-14 00:39:18 +01:00
scripting.txt doc: fix several typos within manual documents 2018-05-09 11:43:23 +01:00
server.txt doc: remove duplicated words 2020-07-14 00:39:18 +01:00
style.txt doc/style: clarify default case for enumerators 2023-09-08 21:58:47 +00:00
target.txt doc: Added MIPS target document 2013-03-13 12:29:54 +00:00