From: David Brownell Date: Thu, 11 Feb 2010 00:42:37 +0000 (-0800) Subject: User's Guide: "#" in filesystems names is bad X-Git-Tag: v0.4.0-rc2~6 X-Git-Url: https://git.sur5r.net/?a=commitdiff_plain;h=527e073bba3145235534a9273e85a714bf87f330;p=openocd User's Guide: "#" in filesystems names is bad Sometimes MS-Windows users try to use filesystem names which include the "#" character. That's generally unwise, since it begins Tcl comments. Signed-off-by: David Brownell --- diff --git a/doc/openocd.texi b/doc/openocd.texi index c1c49a8f..63b6ab01 100644 --- a/doc/openocd.texi +++ b/doc/openocd.texi @@ -539,6 +539,11 @@ Configuration files and scripts are searched for in @end enumerate The first found file with a matching file name will be used. +@quotation Note +Don't try to use configuration script names or paths which +include the "#" character. That character begins Tcl comments. +@end quotation + @section Simple setup, no customization In the best case, you can use two scripts from one of the script @@ -7633,12 +7638,15 @@ in the same basic way. @* Example: @b{ source [find FILENAME] } @*Remember the parsing rules @enumerate -@item The FIND command is in square brackets. -@* The FIND command is executed with the parameter FILENAME. It should -find the full path to the named file. The RESULT is a string, which is -substituted on the orginal command line. -@item The command source is executed with the resulting filename. -@* SOURCE reads a file and executes as a script. +@item The @command{find} command is in square brackets, +and is executed with the parameter FILENAME. It should find and return +the full path to a file with that name; it uses an internal search path. +The RESULT is a string, which is substituted into the command line in +place of the bracketed @command{find} command. +(Don't try to use a FILENAME which includes the "#" character. +That character begins Tcl comments.) +@item The @command{source} command is executed with the resulting filename; +it reads a file and executes as a script. @end enumerate @subsection format command @b{Where:} Generally occurs in numerous places.