- added svn props for newly added files

git-svn-id: svn://svn.berlios.de/openocd/trunk@752 b42882b7-edfa-0310-969c-e2dbd0fdcd60

src/scripting.txt

@@ -1,48 +1,48 @@
-Plan for hosted scripting support in OpenOCD
+Plan for hosted scripting support in OpenOCD
-============================================
+============================================
-Jim Tcl support in OpenOCD currently exists as a patch.
+Jim Tcl support in OpenOCD currently exists as a patch.
-
+
-There has been some discussion on the list as to what
+There has been some discussion on the list as to what
-purpose scripting support might serve in OpenOCD.
+purpose scripting support might serve in OpenOCD.
-
+
-Also Lua was proposed as a scripting language, but 
+Also Lua was proposed as a scripting language, but 
-only Jim Tcl has been forwarded as a patch.
+only Jim Tcl has been forwarded as a patch.
-
+
-Tcl is also backwards syntax compatible with OpenOCD 
+Tcl is also backwards syntax compatible with OpenOCD 
-commands.
+commands.
-
+
-What scripting will not do
+What scripting will not do
-==========================
+==========================
-It is not the intention that normal OpenOCD users will
+It is not the intention that normal OpenOCD users will
-use tcl scripting extensively, write lots of clever scripts,
+use tcl scripting extensively, write lots of clever scripts,
-or contribute back to OpenOCD. 
+or contribute back to OpenOCD. 
-
+
-The scripting support is intended for developers of OpenOCD.
+The scripting support is intended for developers of OpenOCD.
-
+
-Target scripts can contain new procedures that end users may
+Target scripts can contain new procedures that end users may
-tinker to their needs without really understanding tcl.
+tinker to their needs without really understanding tcl.
-
+
-Since end users are not expected to mess with the scripting
+Since end users are not expected to mess with the scripting
-language, the choice of language is not terribly important
+language, the choice of language is not terribly important
-to those same end users.
+to those same end users.
-
+
-Uses of scripting
+Uses of scripting
-=================
+=================
-Default implementation of procedures in tcl/procedures.tcl.
+Default implementation of procedures in tcl/procedures.tcl.
-
+
-- Polymorphic commands for target scripts.
+- Polymorphic commands for target scripts.
-  - there will be added some commands in Tcl that the target
+  - there will be added some commands in Tcl that the target
-    scripts can replace.
+    scripts can replace.
-  - produce <productionfile> <serialnumber>. Default implementation
+  - produce <productionfile> <serialnumber>. Default implementation
-    is to ignore serial number and write a raw binary file
+    is to ignore serial number and write a raw binary file
-    to beginning of first flash. Target script can dictate
+    to beginning of first flash. Target script can dictate
-    file format and structure of serialnumber. Tcl allows
+    file format and structure of serialnumber. Tcl allows
-    an argument to consit of e.g. a list so the structure of
+    an argument to consit of e.g. a list so the structure of
-    the serial number is not limited to a single string.
+    the serial number is not limited to a single string.
-  - reset handling. Precise control of how srst, trst & 
+  - reset handling. Precise control of how srst, trst & 
-    tms is handled.
+    tms is handled.
-- replace some parts of the current command line handler.
+- replace some parts of the current command line handler.
-  This is only to simplify the implementation of OpenOCD
+  This is only to simplify the implementation of OpenOCD
-  and will have no externally visible consequences.
+  and will have no externally visible consequences.
-  Tcl has an advantage in that it's syntax is backwards
+  Tcl has an advantage in that it's syntax is backwards
-  compatible with the current OpenOCD syntax.
+  compatible with the current OpenOCD syntax.