summaryrefslogtreecommitdiff
path: root/src
diff options
context:
space:
mode:
authoroharboe <oharboe@b42882b7-edfa-0310-969c-e2dbd0fdcd60>2008-06-28 09:26:48 +0000
committeroharboe <oharboe@b42882b7-edfa-0310-969c-e2dbd0fdcd60>2008-06-28 09:26:48 +0000
commit731866bd142a8675beaef455ef4bb269241ececa (patch)
tree8876979833bd6dc6e2fff46532f40c52a6daeceb /src
parent7b2a563198a451e5a635034c06100c2fc3a78779 (diff)
downloadopenocd+libswd-731866bd142a8675beaef455ef4bb269241ececa.tar.gz
openocd+libswd-731866bd142a8675beaef455ef4bb269241ececa.tar.bz2
openocd+libswd-731866bd142a8675beaef455ef4bb269241ececa.tar.xz
openocd+libswd-731866bd142a8675beaef455ef4bb269241ececa.zip
wip.
git-svn-id: svn://svn.berlios.de/openocd/trunk@737 b42882b7-edfa-0310-969c-e2dbd0fdcd60
Diffstat (limited to 'src')
-rw-r--r--src/scripting.txt33
1 files 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 <file> <serialnumber>. Default implementation
+ - there will be added some commands in Tcl that the target
+ scripts can replace.
+ - produce <productionfile> <serialnumber>. 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.