The HTML version of the manual pages should have an easy to use navigation panel. The content of the panel is a hierarchical list that possibly can be folded in/out. The current suggestion is to have this structure:
The upper-most level has the following headers:
- Tcl/Tk syntax (i.e. the Dodekalogue, currently on the "Tcl" man page)
- Tcl
- Tk
- Tcl C API
- Tk C API
- ... other packages following here
The panel could also include some links to other documentation pages (such as http://tkdocs.com/) and to the Tcl homepage ("Tcl Developer Site"; https://www.tcl-lang.org).
Specifically, the detailed hierarchical structure would look like this:
- Tcl/Tk syntax
- Tcl
- tclsh application
- Tcl commands
- after
- append
- apply
- ...
- Tcl variables
- argc
- argv
- ...
- Tcl math functions
- Tcl math operators
- Tcl filename conventions ('filename' manual page)
- Tk
- wish application
- Tk commands
- bell
- bind
- bindtags
- ...
- Tk variables
- tk_library
- tk_patchLevel
- ...
- Tk widgets
- button
- canvas
- entry
- ...
- ttk widgets
- ttk::button
- ttk::checkbutton
- ...
- Tk mouse cursors
- Tk colors
- Tk keysyms
- Tcl C API
- attemptckalloc
- attemptckrealloc
- ckalloc
- ckfree
- ckrealloc
- Tcl_Access
- Tcl_AddErrorInfo
- ...
- Tk C API
- Tk_3DBorderColor
- Tk_3DBorderGC
- Tk_3DHorizontalBevel
- Tk_3DVerticalBevel
- Tk_AddOption
- ...