From 55db37d81d2eb2c657b5712ea8e7b0093feb0370 Mon Sep 17 00:00:00 2001 From: Jeff Hobbs Date: Thu, 27 Dec 2012 22:40:53 +0000 Subject: [PATCH] * docs/{dump.man,tkcon.1.man,tkconc.5.man}: make dtplite happy for the docs [Bug #47] --- ChangeLog | 3 ++ docs/dump.n.man | 8 ++-- docs/tkcon.1.man | 110 ++++++++++++++++++++++----------------------- docs/tkconrc.5.man | 76 +++++++++++++++---------------- 4 files changed, 100 insertions(+), 97 deletions(-) diff --git a/ChangeLog b/ChangeLog index e7fed6e..78d760a 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,5 +1,8 @@ 2012-12-27 Jeff Hobbs + * docs/{dump.man,tkcon.1.man,tkconc.5.man}: make dtplite happy for + the docs [Bug #47] + * tkcon.tcl (::tkcon::Init): update to use latest /viewvc/tkcon url to retrieve head version of tkcon. diff --git a/docs/dump.n.man b/docs/dump.n.man index de2839f..9dbccdb 100644 --- a/docs/dump.n.man +++ b/docs/dump.n.man @@ -31,20 +31,20 @@ The various methods are: [list_begin definitions] -[lst_item "[cmd dump] [arg command] [arg args]"] +[def "[cmd dump] [arg command] [arg args]"] Outputs one or more commands. -[lst_item "[cmd dump] [arg procedure] [arg args]"] +[def "[cmd dump] [arg procedure] [arg args]"] Outputs one or more procs in sourceable form. -[lst_item "[cmd dump] [arg variable] [arg args]"] +[def "[cmd dump] [arg variable] [arg args]"] Outputs the values of variables in sourceable form. Recognizes nested arrays. The -filter pattern is used as to filter array element names and is interepreted as a glob pattern (defaults to {*}). It is passed down for nested arrays. -[lst_item "[cmd dump] [arg widget] [arg args]"] +[def "[cmd dump] [arg widget] [arg args]"] Outputs one or more widgets by giving their configuration options. The -filter pattern is used as to filter the config options and is interpreted as a case insensitive regexp pattern (defaults to {.*}). diff --git a/docs/tkcon.1.man b/docs/tkcon.1.man index 038adf9..25ba74b 100644 --- a/docs/tkcon.1.man +++ b/docs/tkcon.1.man @@ -40,24 +40,24 @@ tkcon main set argv {}; tkcon main set argc 0 For these options, any unique substring is allowed. [list_begin definitions] -[lst_item "[cmd -argv] (also [cmd --])"] +[def "[cmd -argv] (also [cmd --])"] Causes TkCon to stop evaluating arguments and set the remaining args to be argv/argc (with [cmd --] prepended). This carries over for any further consoles. This is meant only for wrapping TkCon around programs that require their own arguments. -[lst_item "[cmd -color-] [arg color]"] +[def "[cmd -color-] [arg color]"] Sets the requested color type to the specified color for tkcon. See [cmd tkconrc](5) for the recognized [cmd ] names. -[lst_item "[cmd -eval] [arg tcl_script] (also [cmd -main] or [cmd -e])"] +[def "[cmd -eval] [arg tcl_script] (also [cmd -main] or [cmd -e])"] A Tcl script to eval in each main interpreter. This is evaluated after the resource file is loaded and the slave interpreter is created. Multiple [cmd -eval] switches will be recognized (in order). -[lst_item "[cmd -exec] [arg slavename]"] +[def "[cmd -exec] [arg slavename]"] Sets the named slave that tkcon operates in. In general, this is only useful to set to [arg {""}] (empty), indicating to tkcon to avoid the multi-interpreter model and @@ -67,25 +67,25 @@ in the first tkcon console and not passed onto further new consoles. This is useful when using tkcon as a console for extended wish executables that don't load there commands into slave interpreters. -[lst_item "[cmd -font] [arg font]"] +[def "[cmd -font] [arg font]"] Sets the font that tkcon uses for its text windows. If this isn't a fixed width font, tkcon will override it. -[lst_item "[cmd -nontcl] [arg TCL_BOOLEAN]"] +[def "[cmd -nontcl] [arg TCL_BOOLEAN]"] Sets [cmd ::tkcon::OPT(nontcl)] to [arg TCL_BOOLEAN] (see [cmd tkconrc](5)). Needed when attaching to non-Tcl interpreters. -[lst_item "[cmd -package] [arg package_name] (also [cmd -load])"] +[def "[cmd -package] [arg package_name] (also [cmd -load])"] Packages to automatically load into the slave interpreters (i.e. "Tk"). -[lst_item "[cmd -rcfile] [arg filename]"] +[def "[cmd -rcfile] [arg filename]"] Specify an alternate tkcon resource file name. -[lst_item "[cmd -root] [arg widgetname]"] +[def "[cmd -root] [arg widgetname]"] Makes the named widget the root name of all consoles (i.e. .tkcon). -[lst_item "[cmd -slave] [arg tcl_script]"] +[def "[cmd -slave] [arg tcl_script]"] A Tcl script to eval in each slave interpreter. This will append the one specified in the tkcon resource file, if any. @@ -101,101 +101,101 @@ Only the modified or new bindings are listed here. [list_begin definitions] -[lst_item "[cmd Control-x] or [cmd Cut] (on Sparc5 keyboards)"] +[def "[cmd Control-x] or [cmd Cut] (on Sparc5 keyboards)"] Cut. -[lst_item "[cmd Control-c] or [cmd Copy] (on Sparc5 keyboards)"] +[def "[cmd Control-c] or [cmd Copy] (on Sparc5 keyboards)"] Copy. -[lst_item "[cmd Control-v] or [cmd Paste] (on Sparc5 keyboards)"] +[def "[cmd Control-v] or [cmd Paste] (on Sparc5 keyboards)"] Paste. -[lst_item [cmd Insert]] +[def [cmd Insert]] Insert (duh). -[lst_item [cmd Up]] +[def [cmd Up]] Goes up one level in the commands line history when cursor is on the prompt line, otherwise it moves through the buffer. -[lst_item [cmd Down]] +[def [cmd Down]] Goes down one level in the commands line history when cursor is on the last line of the buffer, otherwise it moves through the buffer. -[lst_item [cmd Control-p]] +[def [cmd Control-p]] Goes up one level in the commands line history. -[lst_item [cmd Control-n]] +[def [cmd Control-n]] Goes down one level in the commands line history. -[lst_item [cmd Tab]] +[def [cmd Tab]] Tries to expand file path names, then variable names, then proc names. -[lst_item [cmd Escape]] +[def [cmd Escape]] Tries to expand file path names. -[lst_item [cmd Control-P]] +[def [cmd Control-P]] Tries to expand procedure names. The procedure names will be those that are actually in the attached interpreter (unless nontcl is specified, in which case it always does the lookup in the default slave interpreter). -[lst_item [cmd Control-V]] +[def [cmd Control-V]] Tries to expand variable names (those returned by [lb]info vars[rb]). It's search behavior is like that for procedure names. -[lst_item "[cmd Return] or [cmd Enter]"] +[def "[cmd Return] or [cmd Enter]"] Evaluates the current command line if it is a complete command, otherwise it just goes to a new line. -[lst_item [cmd Control-a]] +[def [cmd Control-a]] Go to the beginning of the current command line. -[lst_item [cmd Control-l]] +[def [cmd Control-l]] Clear the entire console buffer. -[lst_item [cmd Control-r]] +[def [cmd Control-r]] Searches backwards in the history for any command that contains the string in the current command line. Repeatable to search farther back. The matching substring off the found command will blink. -[lst_item [cmd Control-s]] +[def [cmd Control-s]] As above, but searches forward (only useful if you searched too far back). -[lst_item [cmd Control-t]] +[def [cmd Control-t]] Transposes characters. -[lst_item [cmd Control-u]] +[def [cmd Control-u]] Clears the current command line. -[lst_item [cmd Control-z]] +[def [cmd Control-z]] Saves current command line in a buffer that can be retrieved with another [cmd Control-z]. If the current command line is empty, then any saved command is retrieved without being overwritten, otherwise the current contents get swapped with what's in the saved command buffer. -[lst_item [cmd Control-Key-1]] +[def [cmd Control-Key-1]] Attaches console to the console's slave interpreter. -[lst_item [cmd Control-Key-2]] +[def [cmd Control-Key-2]] Attaches console to the console's master interpreter. -[lst_item [cmd Control-Key-3]] +[def [cmd Control-Key-3]] Attaches console to main TkCon interpreter. -[lst_item [cmd Control-A]] +[def [cmd Control-A]] Pops up the "About" dialog. -[lst_item [cmd Control-N]] +[def [cmd Control-N]] Creates a new console. Each console has separate state, including it's own widget hierarchy (it's a slave interpreter). -[lst_item [cmd Control-q]] +[def [cmd Control-q]] Close the current console OR Quit the program (depends on the value of [cmd ::tkcon::TKCON(slaveexit)]). -[lst_item [cmd Control-w]] +[def [cmd Control-w]] Closes the current console. Closing the main console will exit the program (something has to control all the slaves...). @@ -223,44 +223,44 @@ Here is a non-comprehensive list: [list_begin definitions] -[lst_item "[cmd alias] ?[arg sourceCmd] [arg targetCmd] ?[arg arg] [arg arg] ...??"] +[def "[cmd alias] ?[arg sourceCmd] [arg targetCmd] ?[arg arg] [arg arg] ...??"] Simple alias mechanism. It will overwrite existing commands. When called without args, it returns current aliases. Note that TkCon makes some aliases for you (in slaves). Don't delete those. -[lst_item "[cmd clear] ?[arg percentage]?"] +[def "[cmd clear] ?[arg percentage]?"] Clears the text widget. Same as the <[cmd Control-l]> binding, except this will accept a percentage of the buffer to clear (1-100, 100 default). -[lst_item "[cmd dir] ?[arg -all]? ?[arg -full]? ?[arg -long]?\ +[def "[cmd dir] ?[arg -all]? ?[arg -full]? ?[arg -long]?\ ?[arg pattern] [arg pattern] ...?"] Cheap way to get directory listings. Uses glob style pattern matching. -[lst_item "[cmd dump] [arg type] ?[arg -nocomplain]? ?[arg {-filter pattern}]?\ +[def "[cmd dump] [arg type] ?[arg -nocomplain]? ?[arg {-filter pattern}]?\ ?[cmd --]? [arg pattern] ?[arg pattern] ...?"] The dump command provides a way for the user to spit out state information about the interpreter in a Tcl readable (and human readable) form. See [cmd dump](n) for details. -[lst_item "[cmd echo] ?[arg arg] [arg arg] ...?"] +[def "[cmd echo] ?[arg arg] [arg arg] ...?"] Concatenates the args and spits the result to the console (stdout). -[lst_item "[cmd edit] ?[arg {-type type}]? ?[arg {-find str}]?\ +[def "[cmd edit] ?[arg {-type type}]? ?[arg {-find str}]?\ ?[arg {-attach interp}]? [arg arg]"] Opens an editor with the data from arg. The optional type argument can be one of: [arg proc], [arg var] or [arg file]. For proc or var, the arg may be a pattern. -[lst_item "[cmd idebug] [arg command] ?[arg args]?"] +[def "[cmd idebug] [arg command] ?[arg args]?"] Interactive debugging command. See [cmd idebug](n) for details. -[lst_item "[cmd lremove] ?[arg -all]? ?[arg -regexp] [arg -glob]?\ +[def "[cmd lremove] ?[arg -all]? ?[arg -regexp] [arg -glob]?\ [arg list] [arg items]"] Removes one or more items from a list and returns the new list. If [arg -all] is specified, it removes all instances of each item @@ -268,28 +268,28 @@ in the list. If [arg -regexp] or [arg -glob] is specified, it interprets each item in the items list as a regexp or glob pattern to match against. -[lst_item [cmd less]] +[def [cmd less]] Aliased to [cmd edit]. -[lst_item [cmd ls]] +[def [cmd ls]] Aliased to [cmd dir] [arg -full]. -[lst_item [cmd more]] +[def [cmd more]] Aliased to [cmd edit]. -[lst_item "[cmd observe] [arg type] ?[arg args]?"] +[def "[cmd observe] [arg type] ?[arg args]?"] This command provides passive runtime debugging output for variables and commands. See [cmd observe](n) for details. -[lst_item "[cmd puts] (same options as always)"] +[def "[cmd puts] (same options as always)"] Redefined to put the output into TkCon. -[lst_item "[cmd tkcon] [arg method] ?[arg args]?"] +[def "[cmd tkcon] [arg method] ?[arg args]?"] Multi-purpose command. See [cmd tkcon](n) for details. -[lst_item "[cmd tclindex] [arg {?-extensions patternlist? ?-index TCL_BOOLEAN?\ +[def "[cmd tclindex] [arg {?-extensions patternlist? ?-index TCL_BOOLEAN?\ ?-package TCL_BOOLEAN? ?dir1 dir2 ...?}]"] Convenience proc to update the [file tclIndex] (controlled by [arg -index] switch) and/or [file pkgIndex.tcl] (controlled by [arg -package] switch) file in the named @@ -299,17 +299,17 @@ with the directory defaulting to [lb]pwd[rb]. The extension defaults to *.tcl, with *.[lb]info sharelibextension[rb] added when [arg -package] is true. -[lst_item "[cmd unalias] [arg cmd]"] +[def "[cmd unalias] [arg cmd]"] unaliases command. -[lst_item "[cmd what] [arg string]"] +[def "[cmd what] [arg string]"] The what command will identify the word given in string in the Tcl environment and return a list of types that it was recognized as. Possible types are: alias, procedure, command, array variable, scalar variable, directory, file, widget, and executable. Used by procedures dump and which. -[lst_item "[cmd which] [arg command]"] +[def "[cmd which] [arg command]"] Like the [syscmd which] command of Unix shells, this will tell you if a particular command is known, and if so, whether it is internal or external to the interpreter. diff --git a/docs/tkconrc.5.man b/docs/tkconrc.5.man index 4fe040b..b10af92 100644 --- a/docs/tkconrc.5.man +++ b/docs/tkconrc.5.man @@ -37,98 +37,98 @@ might change or use: [list_begin definitions] -[lst_item [cmd ::tkcon::COLOR(bg)]] +[def [cmd ::tkcon::COLOR(bg)]] The background color for tkcon text widgets. Defaults to the operating system default (determined at startup). -[lst_item [cmd ::tkcon::COLOR(blink)]] +[def [cmd ::tkcon::COLOR(blink)]] The background color of the electric brace highlighting, if on. Defaults to yellow. -[lst_item [cmd ::tkcon::COLOR(cursor)]] +[def [cmd ::tkcon::COLOR(cursor)]] The background color for the insertion cursor in tkcon. Defaults to black. -[lst_item [cmd ::tkcon::COLOR(disabled)]] +[def [cmd ::tkcon::COLOR(disabled)]] The foreground color for disabled menu items. Defaults to dark grey. -[lst_item [cmd ::tkcon::COLOR(proc)]] +[def [cmd ::tkcon::COLOR(proc)]] The foreground color of a recognized proc, if command highlighting is on. Defaults to dark green. -[lst_item [cmd ::tkcon::COLOR(var)]] +[def [cmd ::tkcon::COLOR(var)]] The background color of a recognized var, if command highlighting is on. Defaults to pink. -[lst_item [cmd ::tkcon::COLOR(prompt)]] +[def [cmd ::tkcon::COLOR(prompt)]] The foreground color of the prompt as output in the console. Defaults to brown. -[lst_item [cmd ::tkcon::COLOR(stdin)]] +[def [cmd ::tkcon::COLOR(stdin)]] The foreground color of the stdin for the console. Defaults to black. -[lst_item [cmd ::tkcon::COLOR(stdout)]] +[def [cmd ::tkcon::COLOR(stdout)]] The foreground color of the stdout as output in the console. Defaults to blue. -[lst_item [cmd ::tkcon::COLOR(stderr)]] +[def [cmd ::tkcon::COLOR(stderr)]] The foreground color of stderr as output in the console. Defaults to red. -[lst_item [cmd ::tkcon::OPT(autoload)]] +[def [cmd ::tkcon::OPT(autoload)]] Packages to automatically load into the slave interpreter (i.e. 'Tk'). This is a list. Defaults to {} (none). -[lst_item [cmd ::tkcon::OPT(blinktime)]] +[def [cmd ::tkcon::OPT(blinktime)]] The amount of time (in millisecs) that braced sections should blink for. Defaults to 500 (0.5 secs), must be at least 100. -[lst_item [cmd ::tkcon::OPT(blinkrange)]] +[def [cmd ::tkcon::OPT(blinkrange)]] Whether to blink the entire range for electric brace matching or to just blink the actual matching braces (respectively 1 or 0, defaults to 1). -[lst_item [cmd ::tkcon::OPT(buffer)]] +[def [cmd ::tkcon::OPT(buffer)]] The size of the console scroll buffer (in lines). Defaults to 512. -[lst_item [cmd ::tkcon::OPT(calcmode)]] +[def [cmd ::tkcon::OPT(calcmode)]] Whether to allow expr commands to be run at the command line without prefixing them with expr (just a convenience). -[lst_item [cmd ::tkcon::OPT(cols)]] +[def [cmd ::tkcon::OPT(cols)]] Number of columns for the console to start out with. Defaults to 80. -[lst_item [cmd ::tkcon::OPT(dead)]] +[def [cmd ::tkcon::OPT(dead)]] What to do with dead connected interpreters. If dead is leave, TkCon automatically exits the dead interpreter. If dead is ignore then it remains attached waiting for the interpreter to reappear. Otherwise TkCon will prompt you. -[lst_item [cmd ::tkcon::OPT(exec)]] +[def [cmd ::tkcon::OPT(exec)]] This corresponds to the [cmd -exec] tkcon option (see [cmd tkcon](1)). -[lst_item [cmd ::tkcon::OPT(font)]] +[def [cmd ::tkcon::OPT(font)]] Font to use for tkcon text widgets (also specified with [cmd -font] option). Defaults to the system default, or a fixed width equivalent. -[lst_item [cmd ::tkcon::OPT(gets)]] +[def [cmd ::tkcon::OPT(gets)]] Controls whether tkcon will overload the gets command to work with tkcon. The valid values are: congets (the default), which will redirect stdin requests to the tkcon window; gets, which will pop up a dialog to get input; and {} (empty string) which tells tkcon not to overload gets. This value must be set at startup to alter tkcon's behavior. -[lst_item [cmd ::tkcon::OPT(history)]] +[def [cmd ::tkcon::OPT(history)]] The size of the history list to keep. Defaults to 48. -[lst_item [cmd ::tkcon::OPT(hoterrors)]] +[def [cmd ::tkcon::OPT(hoterrors)]] Whether hot errors are enabled or not. When enabled, errors that are returned to the console are marked with a link to the error info that will pop up in an minimal editor. @@ -137,65 +137,65 @@ maintain bindings for this feature, as long as the error is in the text widget. Defaults to on. -[lst_item [cmd ::tkcon::OPT(library)]] +[def [cmd ::tkcon::OPT(library)]] The path to any tcl library directories (these are appended to the [cmd auto_path] when the after the resource file is loaded in). -[lst_item [cmd ::tkcon::OPT(lightbrace)]] +[def [cmd ::tkcon::OPT(lightbrace)]] Whether to use the brace highlighting feature or not (respectively 1 or 0, defaults to 1). -[lst_item [cmd ::tkcon::OPT(lightcmd)]] +[def [cmd ::tkcon::OPT(lightcmd)]] Whether to use the command highlighting feature or not (respectively 1 or 0, defaults to 1). -[lst_item [cmd ::tkcon::OPT(maineval)]] +[def [cmd ::tkcon::OPT(maineval)]] A tcl script to execute in the main interpreter after the slave interpreter is created and the user interface is initialized. -[lst_item [cmd ::tkcon::OPT(maxlinelen)]] +[def [cmd ::tkcon::OPT(maxlinelen)]] A number that specifies the limit of long result lines. True result is still captured in $_ (and 'puts $_' works). Defaults to 0 (unlimited). -[lst_item [cmd ::tkcon::OPT(maxmenu)]] +[def [cmd ::tkcon::OPT(maxmenu)]] A number that specifies the maximum number of packages to show vertically in the [arg Interp->Packages] menu before breaking into another column. Defaults to 15. -[lst_item [cmd ::tkcon::OPT(nontcl)]] +[def [cmd ::tkcon::OPT(nontcl)]] For those who might be using non-Tcl based Tk attachments, set this to 1. It prevents TkCon from trying to evaluate its own Tcl code in an attached interpreter. Also see my notes for non-Tcl based Tk interpreters. -[lst_item [cmd ::tkcon::OPT(prompt1)]] +[def [cmd ::tkcon::OPT(prompt1)]] Like [cmd tcl_prompt1], except it doesn't require you use [cmd puts]. No equivalent for [cmd tcl_prompt2] is available (it's unnecessary IMHO). Defaults to {([lb]file tail [lb]pwd[rb][rb]) [lb]history nextid[rb] % }. -[lst_item [cmd ::tkcon::OPT(rows)]] +[def [cmd ::tkcon::OPT(rows)]] Number of rows for the console to start out with. Defaults to 20. -[lst_item [cmd ::tkcon::OPT(scollypos)]] +[def [cmd ::tkcon::OPT(scollypos)]] Y scrollbar position. Valid values are left or right. Defaults to right. -[lst_item [cmd ::tkcon::OPT(showmenu)]] +[def [cmd ::tkcon::OPT(showmenu)]] Show the menubar on startup (1 or 0, defaults to 1). -[lst_item [cmd ::tkcon::OPT(showmultiple)]] +[def [cmd ::tkcon::OPT(showmultiple)]] Show multiple matches for path/proc/var name expansion (1 or 0, defaults to 1). -[lst_item [cmd ::tkcon::OPT(slaveeval)]] +[def [cmd ::tkcon::OPT(slaveeval)]] A tcl script to execute in each slave interpreter right after it's created. This allows the user to have user defined info always available in a slave. -[nl] +[para] Example: [example_begin] @@ -205,13 +205,13 @@ set ::tkcon::OPT(slaveeval) { } [example_end] -[lst_item [cmd ::tkcon::OPT(slaveexit)]] +[def [cmd ::tkcon::OPT(slaveexit)]] Allows the prevention of exit in slaves from exitting the entire application. If it is equal to exit, exit will exit as usual, otherwise it will just close down that interpreter (and any children). Defaults to close. -[lst_item [cmd ::tkcon::OPT(subhistory)]] +[def [cmd ::tkcon::OPT(subhistory)]] Allow history substitution to occur (0 or 1, defaults to 1). The history list is maintained in a single interpreter per TkCon console instance. -- 2.23.0