summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorzwelch <zwelch@b42882b7-edfa-0310-969c-e2dbd0fdcd60>2009-06-01 23:09:19 +0000
committerzwelch <zwelch@b42882b7-edfa-0310-969c-e2dbd0fdcd60>2009-06-01 23:09:19 +0000
commit4caa72b9886238975b87ceea94d7dcd51aebde47 (patch)
tree623b829f7d2105973e00613510a60fd3c7f94732
parent7da3c2cda246f010462ac25776651bc5b6163b51 (diff)
downloadopenocd+libswd-4caa72b9886238975b87ceea94d7dcd51aebde47.tar.gz
openocd+libswd-4caa72b9886238975b87ceea94d7dcd51aebde47.tar.bz2
openocd+libswd-4caa72b9886238975b87ceea94d7dcd51aebde47.tar.xz
openocd+libswd-4caa72b9886238975b87ceea94d7dcd51aebde47.zip
David Brownell <david-b@pacbell.net>:
Remove two sections about deprecated/removed commands, documenting them briefly in the chapter on deprecated/removed commands. The "working_area" command just duplicated text; "jtag_device" wasn't listed in that chapter before. Also start de-emphasizing those commands. Don't index them, and include a disclaimer that their documentation may start to vanish about a year after the code does (e.g. in January 2010). git-svn-id: svn://svn.berlios.de/openocd/trunk@1986 b42882b7-edfa-0310-969c-e2dbd0fdcd60
-rw-r--r--doc/openocd.texi64
1 files changed, 22 insertions, 42 deletions
diff --git a/doc/openocd.texi b/doc/openocd.texi
index 028c292f..c890d5be 100644
--- a/doc/openocd.texi
+++ b/doc/openocd.texi
@@ -1823,9 +1823,9 @@ instead of indirectly by making a CPU do it.
@end itemize
+@anchor{jtag newtap}
@section jtag newtap
@b{@t{jtag newtap CHIPNAME TAPNAME configparams ....}}
-@cindex jtag_device
@cindex jtag newtap
@cindex tap
@cindex tap order
@@ -1946,24 +1946,6 @@ have the taps created in the proper order.
@comment END NOTES
@end itemize
@comment at command level
-@comment DOCUMENT old command
-@section jtag_device - REMOVED
-@example
-@b{jtag_device} <@var{IR length}> <@var{IR capture}> <@var{IR mask}> <@var{IDCODE instruction}>
-@end example
-@cindex jtag_device
-
-@* @b{Removed: 28/nov/2008} This command has been removed and replaced
-by the ``jtag newtap'' command. The documentation remains here so that
-one can easily convert the old syntax to the new syntax. About the old
-syntax: The old syntax is positional, i.e.: The 3rd parameter is the
-``irmask''. The new syntax requires named prefixes, and supports
-additional options, for example ``-expected-id 0x3f0f0f0f''. Please refer to the
-@b{jtag newtap} command for details.
-@example
-OLD: jtag_device 8 0x01 0xe3 0xfe
-NEW: jtag newtap CHIPNAME TAPNAME -irlen 8 -ircapture 0x01 -irmask 0xe3
-@end example
@section Enable/Disable Taps
@b{Note:} These commands are intended to be used as a machine/script
@@ -2376,15 +2358,6 @@ processor. You still need to enable @option{srst} on the reset
configuration command to enable OpenOCD hardware reset functionality.
@comment END variants
@end itemize
-@section working_area - Command Removed
-@cindex working_area
-@*@b{Please use the ``$_TARGETNAME configure -work-area-... parameters instead}
-@* This documentation remains because there are existing scripts that
-still use this that need to be converted.
-@example
- working_area target# address size backup| [virtualaddress]
-@end example
-@* The target# is a the 0 based target numerical index.
@node Flash Commands
@chapter Flash Commands
@@ -4515,7 +4488,14 @@ is jim, not real tcl).
@node Upgrading
@chapter Deprecated/Removed Commands
@cindex Deprecated/Removed Commands
-Certain OpenOCD commands have been deprecated/removed during the various revisions.
+Certain OpenOCD commands have been deprecated or
+removed during the various revisions.
+
+Upgrade your scripts as soon as possible.
+These descriptions for old commands may be removed
+a year after the command itself was removed.
+This means that in January 2010 this chapter may
+become much shorter.
@itemize @bullet
@item @b{arm7_9 fast_writes}
@@ -4523,34 +4503,39 @@ Certain OpenOCD commands have been deprecated/removed during the various revisio
@*Use @command{arm7_9 fast_memory_access} instead.
@xref{arm7_9 fast_memory_access}.
@item @b{arm7_9 force_hw_bkpts}
-@cindex arm7_9 force_hw_bkpts
@*Use @command{gdb_breakpoint_override} instead. Note that GDB will use hardware breakpoints
for flash if the GDB memory map has been set up(default when flash is declared in
target configuration). @xref{gdb_breakpoint_override}.
@item @b{arm7_9 sw_bkpts}
-@cindex arm7_9 sw_bkpts
@*On by default. @xref{gdb_breakpoint_override}.
@item @b{daemon_startup}
-@cindex daemon_startup
@*this config option has been removed, simply adding @option{init} and @option{reset halt} to
the end of your config script will give the same behaviour as using @option{daemon_startup reset}
and @option{target cortex_m3 little reset_halt 0}.
@item @b{dump_binary}
-@cindex dump_binary
@*use @option{dump_image} command with same args. @xref{dump_image}.
@item @b{flash erase}
-@cindex flash erase
@*use @option{flash erase_sector} command with same args. @xref{flash erase_sector}.
@item @b{flash write}
-@cindex flash write
@*use @option{flash write_bank} command with same args. @xref{flash write_bank}.
@item @b{flash write_binary}
-@cindex flash write_binary
@*use @option{flash write_bank} command with same args. @xref{flash write_bank}.
@item @b{flash auto_erase}
-@cindex flash auto_erase
@*use @option{flash write_image} command passing @option{erase} as the first parameter. @xref{flash write_image}.
+@item @b{jtag_device}
+@*use the @command{jtag newtap} command, converting from positional syntax
+to named prefixes, and naming the TAP.
+@xref{jtag newtap}.
+Note that if you try to use the old command, a message will tell you the
+right new command to use; and that the fourth parameter in the old syntax
+was never actually used.
+@example
+OLD: jtag_device 8 0x01 0xe3 0xfe
+NEW: jtag newtap CHIPNAME TAPNAME \
+ -irlen 8 -ircapture 0x01 -irmask 0xe3
+@end example
+
@item @b{jtag_speed} value
@*@xref{JTAG Speed}.
Usually, a value of zero means maximum
@@ -4565,10 +4550,8 @@ speed. The actual effect of this option depends on the JTAG interface used.
@end itemize
@item @b{load_binary}
-@cindex load_binary
@*use @option{load_image} command with same args. @xref{load_image}.
@item @b{run_and_halt_time}
-@cindex run_and_halt_time
@*This command has been removed for simpler reset behaviour, it can be simulated with the
following commands:
@smallexample
@@ -4577,13 +4560,10 @@ sleep 100
halt
@end smallexample
@item @b{target} <@var{type}> <@var{endian}> <@var{jtag-position}>
-@cindex target
@*use the create subcommand of @option{target}.
@item @b{target_script} <@var{target#}> <@var{eventname}> <@var{scriptname}>
-@cindex target_script
@*use <@var{target_name}> configure -event <@var{eventname}> "script <@var{scriptname}>"
@item @b{working_area}
-@cindex working_area
@*use the @option{configure} subcommand of @option{target} to set the work-area-virt, work-area-phy, work-area-size, and work-area-backup properties of the target.
@end itemize