Tcl Source Code

If I go to the 8.6 manpages online, I get links to docs of contributed packages. All of which are broken except for the one for SQLite. For example, “TDBC Package Commands” (in the heading part) does not lead anywhere.

Seems to be working now.

I should also note that merely adding a package doesn't require the mapping to be updated, provided that the default mapping (with string totitle IIRC) is enough.

Well, the package.list.txt is the only way to get the correct mapping between package directory root name and documented package name. I've not found anything in any of the packages that gives this information; it's not in the configure.in or the README or the documentation files.

As far as curation overhead goes, it's tiny. Certainly smaller than the effort of actually finding which version of the packages to distribute.

The good news here is that the distributed documentation
release tcl8.6.1-html.tar.gz generated by `make html` is in
fine shape.  No broken links in it.

The failures showed up entirely in my transference of the
files in that distribution onto the web server machine.

I have to catch up on this.  One thing I see already committed which I will try to undo is the distribution of the "package.list.txt" file.  That was *not*
an oversight.  It was intentionally and explicitly not made part of the
source code distribution.

If we truly have to change to a fully cataloged and curated system
to make bundled packages work, then the whole system needs a re-think.
The explicit intent has been to *not* have manifests or catalogs or anything
like that but have the build harness just discover the set of bundled
packages as they happen to be or not be present under tcl/pkgs.

I've done what fixes I can do; the one thing I can't (or at least don't know how to) is push a new doc build to www.tcl.tk.

OK, it appears that the problem was that make install was not done before make html. Starting with the distribution archives of Tcl and Tk, unpacked next to each other, and then installed (e.g., in /tmp) before doing the doc build, I get a complete and working documentation set.

Except for one minor bug in link recognition in a third-party package.

Note that this might be due to problems in the deployment — e.g., only deploying part of the documentation build — or something going wrong with the link generation.

This has been mentioned on comp.lang.tcl.