Google Groups no longer supports new Usenet posts or subscriptions. Historical content remains viewable.
Dismiss

ANNOUNCE: Combined Windows CHM help file for Tcl/Tk and extensions

174 views
Skip to first unread message

Ashok

unread,
Jan 9, 2019, 11:47:09 PM1/9/19
to
By popular request :-), a new release of a Windows Help file containing
documentation for Tcl/Tk and commonly used extensions is available from
https://sourceforge.net/projects/magicsplat/files/tcl-docs/ (note
location has changed from previous).


The directory contains a Windows CHM format help files containing
a compilation of the documentation for Tcl/Tk and the most
commonly used extensions and libraries.

WARNING:

When you open the file, you may see the table of contents pane but with
an empty pane for the actual content. This is Microsoft's noble attempt
to protect you from the big bad Internet. Right click on the downloaded
file and on the General tab at the bottom you will see some gibberish
about the file having been downloaded from the Internet. Click on the
Unblock button next to that warning. That should do make the content
visible.

Advantages over various other documentation sources are:

* Comprehensive, detailed table of contents. In particular, Tcl commands
or C functions within a single page have individual entries. For
example,

* Subcommands, such as string match

* Widget options, such as -activebackground

* Options and specifiers, such as %f focus specifier all have
their own entries.

* A combined and detailed index makes it easy and quick to locate
specific information. For example,

* Combined index - typing try in the index input box will show the
the TWAPI as well as Tcl versions of try.

* Index includes subcommands - string match links directly to the
description of the match subcommand of the string command.

* Entries for options, format or event specifiers, bindings etc. -
%EE links to the description for this specifier in the clock
command documentation. Similarly, <<MenuSelect>> will take you
to the description for that event.

* Full text content search. Together with incremental lookup, this makes
locating information very quick and easy.


two...@gmail.com

unread,
Jan 10, 2019, 3:45:08 AM1/10/19
to
On Wednesday, January 9, 2019 at 8:47:09 PM UTC-8, Ashok wrote:
> By popular request :-), a new release of a Windows Help file

Wow, thanks so much. And 3 new sections to boot!


Harald Oehlmann

unread,
Jan 10, 2019, 4:14:02 AM1/10/19
to
Thank you, Ashok !

s.effe...@googlemail.com

unread,
Jan 10, 2019, 4:15:15 AM1/10/19
to
Minor nitpick: Some part of the toolchain doesn't seem to be fully aware of non-ASCII encodings. I see e.g.

tclsh — Simple shell containing Tcl interpreter

and the copyright of huddle reads

Copyright © 2015 Miguel Martínez López

Miguel Martínez López will not be amused ...
I can properly decipher ActiveState's CHM file, so I can fairly (99%) assume that the problem is not on my side.

Apart from that, thanks for an up-to-date doc file!

Bert Cuzeau

unread,
Dec 2, 2020, 7:33:43 AM12/2/20
to
Thank you Ashok.
I used to move my old (salvaged) chm file from computer to computer, and ended up losing it.
I have been using (and teaching Tcl) for more years than I'd like to admit, and I grew too much used to this format (off-line, compact, readable without a browser and well organized).
However, I miss the original hierarchical organisation of the Tcl commands.
But it's much more up-to-date than the original.
Thanks.

Ashok

unread,
Dec 4, 2020, 12:23:42 AM12/4/20
to
I'm afraid the integrated help CHM file is no longer maintained. Instead
you might want to try out the online version which is also fully indexed
and of course not limited to Windows.

Table of contents: https://www.magicsplat.com/tcl-docs/index.html
Index (with incremental search):
https://www.magicsplat.com/tcl-docs/docindex.html

/Ashok

Harald Oehlmann

unread,
Dec 4, 2020, 9:08:59 AM12/4/20
to
Nevertheless I still use it, outdated or not, it is handy.
Thank you anyway,
Harald
0 new messages