Re: typical TCL docu nonsens

On 6/21/2024 2:55 PM, Rich wrote:

et99 <et99@rocketship1.me> wrote:

On 6/21/2024 1:17 PM, aotto1968 wrote:
snip

>
the core problem is *not* the "autopath" is wrong because at the
time I use it I does not know it was wrong.  The core problem is
that is was *very* difficult to figure out what was the "right"
name.  special the tcl_traceExec… does not help and more important
the package.n docu (package require…) does *not* spend a single word
on *how* to find a package.

snip

So the least disruptive change to cover aotto1968's complaint would be
for aotto1968 to file a patch against the package man page adding a
"see tcl_library manpage for Tcl special variables related to package
handling".
 That, or aotto1968 should file a patch against the package namespace to
add a brief paragraph to the package manpage detailing that the special
global auto_path contains a list of directories within which to search
for packages when doing a package require.
 Either of the above would be a proactive step to eliminate the problem.
 

Being that I'm mostly on windows, I use Ashok's documentation website. His index is great, and you can pre-load a search term, like so:
https://www.magicsplat.com/tcl-docs/docindex.html?search=tclvars
which takes you directly to the tclvars page where auto_path is the first variable described.
Now that Ashok is part of the core team (yay!) I think something like his webtools would be a great addition to the official tcl documentation, if Ashok would approve of such.
I use his tool from within my text editor, where the word under the cursor can be sent off as the search term using the above url and sending it through to chrome, all with a single keystroke.
Truly great resource!