From 731866bd142a8675beaef455ef4bb269241ececa Mon Sep 17 00:00:00 2001 From: oharboe Date: Sat, 28 Jun 2008 09:26:48 +0000 Subject: [PATCH] wip. git-svn-id: svn://svn.berlios.de/openocd/trunk@737 b42882b7-edfa-0310-969c-e2dbd0fdcd60 --- src/scripting.txt | 33 ++++++++++++++++++++++++++++----- 1 file changed, 28 insertions(+), 5 deletions(-) diff --git a/src/scripting.txt b/src/scripting.txt index 7242e73f..dd706165 100644 --- a/src/scripting.txt +++ b/src/scripting.txt @@ -11,15 +11,38 @@ only Jim Tcl has been forwarded as a patch. Tcl is also backwards syntax compatible with OpenOCD commands. +What scripting will not do +========================== +It is not the intention that normal OpenOCD users will +use tcl scripting extensively, write lots of clever scripts, +or contribute back to OpenOCD. + +The scripting support is intended for developers of OpenOCD. + +Target scripts can contain new procedures that end users may +tinker to their needs without really understanding tcl. + +Since end users are not expected to mess with the scripting +language, the choice of language is not terribly important +to those same end users. + Uses of scripting ================= - Default implementation of procedures in tcl/procedures.tcl. - Polymorphic commands for target scripts. - - produce . Default implementation + - there will be added some commands in Tcl that the target + scripts can replace. + - produce . Default implementation is to ignore serial number and write a raw binary file - to beginning of first flash. + to beginning of first flash. Target script can dictate + file format and structure of serialnumber. Tcl allows + an argument to consit of e.g. a list so the structure of + the serial number is not limited to a single string. - reset handling. Precise control of how srst, trst & - tms is handled and when. - \ No newline at end of file + tms is handled. +- replace some parts of the current command line handler. + This is only to simplify the implementation of OpenOCD + and will have no externally visible consequences. + Tcl has an advantage in that it's syntax is backwards + compatible with the current OpenOCD syntax. -- 2.39.5