Many hyperlinks are disabled.
Use anonymous login
to enable hyperlinks.
History of file help.tcl at check-in b53665eee8f46192
|
2016-06-29
| ||
| 07:54 | officers/private * Renamed 'ehandler' to intercept. Documented the change. Kept the old name around, deprecated it. * Renamed 'shandler' to custom-setup, and documented it. Extended the implementation to support a list of customizations, instead of a single. * Fixed handling of *prefix* for --help. Code wrongly extended the local copy of the block, instead of the root copy. Updated docs, change information. Regenerated the embedded docs. file: [739efc11d4] check-in: [cabf535e47] user: aku branch: trunk, size: 17770 | |
|
2016-06-22
| ||
| 19:01 | Renamed help.tcl → help/help.tcl. Restructured the file hierarchy, sorted the package files into related groups. file: [feef70d9ac] check-in: [b09c92cbff] user: aku branch: trunk, size: 17668 | |
| 18:41 | Extended the integrated help system to declare a global option --help (-h, -?), inherited by all commands to provide their help. Updated the testsuite. file: [feef70d9ac] check-in: [56a4c28f89] user: aku branch: trunk, size: 17668 | |
|
2014-11-04
| ||
| 18:05 | cmdr::help - Prevent the space allocated to descriptions in the categorized help from getting to small. Negatives trigger an error in adjust, and anything below 10 will generate very short tall columns. Better to misformat (cut at terminal edge, or wrap-around) for these cases. Bumped version to 1.3.2. file: [ca0266bf18] check-in: [b64206b4e3] user: andreask branch: trunk, size: 16474 | |
|
2014-09-10
| ||
| 20:35 | Move handling of global option to before checking for a command. We can now enter a main shell with global options set. Bump version numbers. file: [fddb1bcb0f] check-in: [2bfa8d5785] user: andreask branch: trunk, size: 16271 | |
| 20:21 | Moved handling of option arguments in help to separate proc. Reworked the handling of global options to show arguments as well. Fixed sorting of section display when seeing options with arguments. file: [1edb3a54e9] check-in: [f41f44de14] user: andreask branch: trunk, size: 16269 | |
|
2014-08-29
| ||
| 20:19 | cmdr::parameter - Extended spec with description of option argument, if any. cmdr::help - Modified to make use of the new information in help texts. file: [1698a1f440] check-in: [463519edc6] user: andreask branch: trunk, size: 15975 | |
| 05:07 | Tweaked output for help --full, added option arguments for options requiring them. file: [9648100d02] check-in: [84658915a6] user: aku branch: trunk, size: 15898 | |
|
2014-08-26
| ||
| 19:58 | Fix oops. file: [ff97aff5e3] check-in: [febbd538cd] user: andreask branch: trunk, size: 15448 | |
| 19:45 | Updated help generation to show global options in categorized help. General update to handle officers now appearing in the help structures. Bumped version numbers. All parts done. Notes removed. file: [3a62e91ec5] check-in: [f853a46223] user: andreask branch: global-options, size: 15448 | |
|
2014-06-03
| ||
| 20:40 | cmdr::help, cmdr::pager - Moved the paging support into a separate package, for use outside of the help code. Functiomnality tweak: Linenoise not supporting querying the height does not disable paging, just goes with a default height. file: [b7604c2c0f] check-in: [ff5bdec2ca] user: andreask branch: trunk, size: 14431 | |
| 00:24 | cmdr::help - Added option to forcibly disable the pager. file: [a9030dbd94] check-in: [a52e457615] user: andreask branch: trunk, size: 15545 | |
| 00:19 | Fix stupid typo in definition of the Pager support command. file: [74e7b2b142] check-in: [d4b3af213d] user: andreask branch: trunk, size: 15408 | |
| 00:16 | cmdr::help - Extended the backend to invoke a pager if the help is too high for the terminal. Lots of things (not terminal, no support in linenoise, no pager) will disable this. Bumped version to 1.3. file: [771bf1f3f1] check-in: [e15928b830] user: andreask branch: trunk, size: 15416 | |
|
2014-04-15
| ||
| 19:30 | help - Switched to method "extend" over "learn" to define the command, simpler. file: [e890467a31] check-in: [4add0ceabc] user: andreask branch: trunk, size: 14088 | |
|
2014-02-17
| ||
| 23:29 | Excluded auto-added commands from categorized help. file: [103528f10c] check-in: [7e77c5a0be] user: andreask branch: trunk, size: 14126 | |
| 20:20 | Tweak to default format selection of help, use "short" for interior nodes. file: [c1d5df8dbe] check-in: [ac17c7fb74] user: andreask branch: trunk, size: 13976 | |
|
2014-02-06
| ||
| 06:18 | Remade "help::query-actor" as method "find" of officers and private. Simplified the internals of auto-help. Provides the path lookup to framework users as well. Updated the documentation. file: [ec5564f65e] check-in: [5487358492] user: aku branch: trunk, size: 13766 | |
| 05:35 | Added utility package cmdr::help::tcl, dumping the help as Tcl data structure. Like cmdr::help::json, with less overhead to read into other Tcl code. file: [446c566e8b] check-in: [865912b8d9] user: aku branch: trunk, size: 14550 | |
| 05:05 | Fixed problems with the generation of categorized help when encountering sections with sub-sections, but no commands file: [de1c337eac] check-in: [11fff41159] user: aku branch: trunk, size: 14536 | |
|
2014-01-13
| ||
| 21:03 | Fixed buglet in the help setup. Add the main (root) name to the command prefix when not in a cli shell. Bumped cmdr::help to version 1.0.1. file: [4a69a8759f] check-in: [60dbdef1b0] user: andreask branch: trunk, size: 14164 | |
|
2013-12-02
| ||
| 17:44 | Version bumped to 1.0. Regenerated docs. file: [34509dc55f] check-in: [2e15301ff5] user: aku branch: trunk, size: 13928 | |
|
2013-11-22
| ||
| 20:52 | Modified officers. Auto-create an 'exit'-command, if not in conflict with user commands. Method as backend for private. Usable by others as well. Bumped version to 0.14. file: [132a39e294] check-in: [8d7fcadf53] user: andreask branch: trunk, size: 13929 | |
|
2013-11-17
| ||
| 01:01 | Added a behaviour flag "no-promote" to parameters, to allow rejection of promotion of unknown flag strings to input values on principle. Bumped version to 0.13, updated embedded documentation. file: [f7885be51e] check-in: [b9126a7a27] user: aku branch: trunk, size: 13929 | |
|
2013-11-16
| ||
| 23:15 | Moved dictsort utility into util for wider use. Sort parts of the help structures for easier testing. Fixed bugs in the help generation (1) Skip imported helper commands which are not formats. (2) Rendering of list inputs was off. -- Bumped version to 0.12, help (json, sql) to 0.2, fixed requirements -- Updated embedded documentation. file: [92d18efe54] check-in: [0ed8f3610b] user: aku branch: trunk, size: 13929 | |
|
2013-11-15
| ||
| 23:10 | Extended the shells to note their activity in a root common block named *in-shell*. Bumped version to 0.11. file: [f2b1c2a647] check-in: [5a480bf9d8] user: andreask branch: trunk, size: 13955 | |
|
2013-11-04
| ||
| 17:38 | Reworked the interaction for entry of scalar, and general calculation of the value - Show validation error message for proper feedback - Trap ^C properly, as done for the list-case already. Scalar was forgotten. - Report the ^C as 'undefined value' - Remember the undefined-ness and have additional attempts to retrieve the value abort early This prevents retries of computing the value where we cannot succeed. It also prevents additional attempts at interaction. Bumped version to 0.10. file: [a860b7dd3e] check-in: [d2a2bc511f] user: andreask branch: trunk, size: 13955 | |
|
2013-10-31
| ||
| 00:48 | Fix oops, forgotten update of by-category for the new helper procedures. file: [0f4141dd47] check-in: [0a71af63c2] user: andreask branch: trunk, size: 13954 | |
| 00:43 | Extended the json format with better section information, and outer structure. Version bumped to 0.9 file: [1bfb0d1142] check-in: [a190c9c157] user: andreask branch: trunk, size: 13934 | |
|
2013-10-29
| ||
| 05:45 | Bumped package versions to 0.8 file: [d9254e3bfc] check-in: [a0fad5ad9d] user: aku branch: trunk, size: 13572 | |
|
2013-10-18
| ||
| 00:30 | Bumped cmdr version to 0.7 file: [f1680188f2] check-in: [b2ff231a4e] user: andreask branch: trunk, size: 13572 | |
|
2013-10-17
| ||
| 18:17 | Bumped cmdr version to 0.6 file: [4f14e4dc5a] check-in: [e3e822290d] user: andreask branch: trunk, size: 13572 | |
| 18:16 | Tweaked the formatting of arguments in the generated help. file: [00d7c830e8] check-in: [fe780034dd] user: andreask branch: trunk, size: 13572 | |
|
2013-10-16
| ||
| 19:21 | Bumped cmdr version to 0.5 file: [b3720beccd] check-in: [41becb3194] user: andreask branch: trunk, size: 13561 | |
| 19:20 | Extended DSL for privates with command to record category/section information for help. Extended the help system with a by-category format, and made it default when not looking for a specific command. ATTENTION: The API between help core and formats did change, the root actor of the command tree is now supplied. New common block *category-order* to declare a bespoke ordering of categories. file: [2500b3c71d] check-in: [465f1bd7c6] user: andreask branch: trunk, size: 13561 | |
|
2013-10-15
| ||
| 23:46 | Tweaked the auto-help command. Default to full format only when asking for a specific command, otherwise default to a simple list. file: [fc9a764fab] check-in: [f4a5130c2e] user: andreask branch: trunk, size: 9097 | |
|
2013-09-18
| ||
| 19:24 | Tweaked help system. Added option "--width" enabling explicit control of the line width to format for. Default via "linenoise columns". file: [4ec934d076] check-in: [b53665eee8] user: andreask branch: trunk, size: 8878 | |
|
2013-08-29
| ||
| 05:34 | Fix forgotten internal use of when-set (callback signature change). file: [2e4f750277] check-in: [1b16ff6c0f] user: aku branch: trunk, size: 8357 | |
|
2013-08-23
| ||
| 18:52 | New feature: Parameter labels, override name shown in help. Plus new config method to query parameter existence. file: [cad3753231] check-in: [da6a48c70d] user: andreask branch: trunk, size: 8368 | |
|
2013-08-21
| ||
| 20:04 | Bump version to 0.4. Parameter API changes. * "defined?" becomes "set?". * "when-defined" becomes "when-complete". * The "default" value is now handled as int.rep, not going through validation. (Like the result of the "generate" callback). * Updated validation type "default" to always provide something. * Standard VT fail now takes parameter instance command as first argument (see also below about callbacks), and uses it to generate an enhanced error message (naming the parameter at issue). Callback API changes. * All callbacks now take the parameter instance command as their first argument. * Removed the (class)methods to dynamically locate and access a innermost config instance on the stack. * As replacement added method "config" to make the container accessible from each parameter it contains, and thus all other parameters as well. * Update all validation types. file: [0729470eeb] check-in: [abe9e7a804] user: andreask branch: trunk, size: 8269 | |
|
2013-08-02
| ||
| 23:45 | Reworked the help data structures to show much more of the internals in the json format, and updated the standard formats for it. file: [1ae6de8b67] check-in: [8b8ed7f0f5] user: andreask branch: trunk, size: 8269 | |
| 22:07 | Added a bit more debug narrative in the help support file: [e0445b597d] check-in: [0472dca221] user: andreask branch: trunk, size: 9257 | |
| 21:33 | Added defered/immediate distinction for parameters, with state defaulting to defered, and the others as immediate. Updated tests. Bumped version to 0.3. file: [bf0cda66f6] check-in: [a81d6b881f] user: andreask branch: trunk, size: 9185 | |
|
2013-07-02
| ||
| 18:20 | Bump version to 0.2 file: [fc6f33423d] check-in: [c576a5a9ef] user: andreask branch: trunk, size: 9185 | |
|
2013-06-24
| ||
| 16:56 | Fixed isue with help generator. Handle possibility of more words to resolve after having reached a leaf of the command tree. file: [a066e3dc86] check-in: [dac3fcc75f] user: andreask branch: trunk, size: 9185 | |
|
2013-05-22
| ||
| 21:52 | Sort help by command name. file: [fc2c9c6f45] check-in: [e7ffa0b314] user: andreask branch: trunk, size: 8812 | |
| 21:29 | Added author and location meta data. file: [78796aab9f] check-in: [d473b0c8bc] user: andreask branch: trunk, size: 8646 | |
| 20:39 | Added teapot meta data to all cmdr packages. file: [327c5340a3] check-in: [5d1611cb80] user: andreask branch: trunk, size: 8562 | |
|
2013-04-05
| ||
| 19:59 | Added debug narrative to the system, based on the new tcllib/debug packages. file: [566537a09c] check-in: [fbf43a6c26] user: andreask branch: trunk, size: 8127 | |
|
2013-04-04
| ||
| 05:00 | Second charge of renaming "xo" to "cmdr". Plus tweak to processing of optional list arguments, preventing ahead-processing of options. They are made part of the splat. file: [759d8e1d0f] check-in: [e756a91488] user: aku branch: trunk, size: 7852 | |
| 04:46 | Renamed and modified xo_help.tcl → help.tcl. Renamed everything from "xo" to "cmdr". Easier to speak and more direct connection between name and purpose of the package. file: [f63a1ad13f] check-in: [91f2eaba78] user: aku branch: trunk, size: 7850 | |
|
2013-03-23
| ||
| 18:04 | Updated the testsuite to account for the auto-help command introduced with [63db617e97]. file: [e0155896e3] check-in: [56a8582121] user: aku branch: trunk, size: 7808 | |
|
2013-03-22
| ||
| 21:50 | Shifted responsibility for excluding undocumented actors to the callers, not the actors themselves. Renamed help format "plain" to "full". Generate an automatic help command self-configured for the known formats (officers only, privates have pseudo-command ".help"). Bound into the general framework it can partake in completion, etc. Note: Argument completion currently not done, put possible (introspection on the command tree) file: [ab83aa64f5] check-in: [63db617e97] user: andreask branch: trunk, size: 7784 | |
| 20:46 | Fixed missing initialization of result lists file: [f8a1e55019] check-in: [4ba6bd1c96] user: andreask branch: trunk, size: 6354 | |
|
2013-03-21
| ||
| 05:40 | Multiple changes: - Updated testsuite for [00b6c20621]. - Added 'interactive' setting to privates. Default no prevents testsuite from going into interactive mode. - Dropped undocumented options from shown state and command completion (Interactive entry of arguments for a private). Exceptions: Still available as commands, and shown/completed when user has already entered data, proving their knowledge of them. - New pseudo-command .help, show help for the current command. - Help formatting: No empty lines when description is empty. - Additional help formats: list, and short file: [1ea4f26680] check-in: [4c73bb7f4d] user: aku branch: trunk, size: 6300 | |
|
2013-03-17
| ||
| 09:08 | Moved string utility out of help to general utility package file: [44535785de] check-in: [60628e9e00] user: aku branch: trunk, size: 3929 | |
|
2013-03-09
| ||
| 00:11 | Help generation fix, set the resolved name chain as command name prefix. Note issue with option documentation. file: [5d19497593] check-in: [0c23456d73] user: andreask branch: trunk, size: 4199 | |
|
2013-03-08
| ||
| 21:34 | Added: In source doc tweak. Plus new package, help query and formatting support/conveniences. file: [f1fdbc642d] check-in: [14a2201b7e] user: andreask branch: trunk, size: 4192 | |