--- **[tickets:#403] `program` script/command and documenation not consistent?** **Status:** new **Milestone:** 0.11.0 **Created:** Tue Jun 27, 2023 08:41 PM UTC by Tommy Murphy **Last Updated:** Tue Jun 27, 2023 08:41 PM UTC **Owner:** nobody As far as I can see, the implementation of and documentation for the `program` helper command/script are not in alignment. The `program` helper command/script is implemented in `openocd/src/flash/startup.tcl` * https://github.com/openocd-org/openocd/blob/eebcf3cff16afbce2c57cf2dba6f562e17713093/src/flash/startup.tcl#L21 The usage text here: * https://github.com/openocd-org/openocd/blob/eebcf3cff16afbce2c57cf2dba6f562e17713093/src/flash/startup.tcl#L104C1-L105C93 says ``` add_help_text program "write an image to flash, address is only required for binary images. verify, reset, exit are optional" add_usage_text program "<filename> \[address\] \[pre-verify\] \[verify\] \[reset\] \[exit\]" ``` But the documentation here: * https://openocd.org/doc/html/Flash-Commands.html#program says > Command: program filename [preverify] [verify] [reset] [exit] [offset] The two descriptions do not seem to match - note the presence and placement of `address` and `offset`: > program "<filename> \[address\] \[pre-verify\] \[verify\] \[reset\] \[exit\]" > Command: program filename [preverify] [verify] [reset] [exit] [offset] Also - neither the documenation above nor the additional link here: * https://openocd.org/doc/html/Flash-Programming.html clearly and comprehensively explains all options. --- Sent from sourceforge.net because openocd-devel@lists.sourceforge.net is subscribed to https://sourceforge.net/p/openocd/tickets/ To unsubscribe from further messages, a project admin can change settings at https://sourceforge.net/p/openocd/admin/tickets/options. Or, if this is a mailing list, you can unsubscribe from the mailing list.
