|
2026-10-21
| ||
| 17:54 | • Ticket [b2e3cbdc8f] `make html` fails status still Open with 3 other changes artifact: 04a4fc3337 user: dgp | |
|
2026-10-20
| ||
| 12:40 | • Ticket [b2e3cbdc8f]: 4 changes artifact: cc9431b2e3 user: serhiy.storchaka | |
| 12:39 | Fix [b2e3cbdc8f]: "make html" failed with "not table of contents" when the Tk source directory had a... leaf check-in: 09a2f4899f user: serhiy.storchaka tags: man2html-find-tk-generic | |
|
2023-12-20
| ||
| 16:10 | • Ticket [b2e3cbdc8f] `make html` fails status still Open with 3 other changes artifact: f0be38aeef user: dgp | |
|
2023-12-15
| ||
| 19:47 | • Ticket [b2e3cbdc8f]: 3 changes artifact: b7a222a920 user: dgp | |
| 19:46 | • New ticket [b2e3cbdc8f]. artifact: 513081d530 user: dgp | |
| Ticket UUID: | b2e3cbdc8fedeff29be5355576ac9e9af3a3d4f3 | ||
| Title: | `make html` fails | ||
| Type: | Bug | Created on: | 2023-12-15 19:46:59 |
| Submitter: | dgp | Assigned to: | dkf |
| Subsystem: | 53. Configuration and Build Tools | Severity: | Minor |
| Priority: | 5 Medium | Last modified: | 2026-10-21 17:54:01 |
| Status: | Open | Closed by: | nobody |
| Resolution: | None | Closed on: | |
| Version: | 9.1.0 | ||
| Description: | ||||
$ make html ... using Tcl source directory /home/dgp/fossil/tcl9.0b1 using Tk source directory verbose messages are off scanning section Tcl/Tk Applications : make-manpage-section: not table of contents. make: *** [html] Error 1 | ||||
| User Comments: | ||||
dgp added on 2023-12-15 19:47:52:
The targets `make html-tcl` and `make html-tk` do appear to work, and their combination is presumably the desired result. dgp added on 2023-12-20 16:10:40:
The `make html` target passes the command line argument --useversion=$(MAJOR_VERSION).$(MINOR_VERSION) which in this case sets the value to "9.0" This is odd since my sandboxes are under directories named tcl9.0b1 and tk9.0b1 which matches what the releases will unpack into, and what any downstream user will most likely have. I can work around the problem by using symlinks to create the appearance of the directories tcl9.0 and tk9.0 that the existing code is looking for. That will do for now, but doesn't really seem to be the right answer. FWIW the [findversion] routine inside the man2html machinery seems to be a real mess. serhiy.storchaka added on 2026-10-20 12:40:54:
Reproduced on main with source directories named tcl9.1b1 and tk9.1b1, exactly as reported. The cause is in findversion in tools/tcltk-man2html.tcl: foreach top1 {$top $top/..} sub {{} generic} pairs the two lists, so it only tries $top/<dir>/tk.h and $top/../<dir>/generic/tk.h. After Tcl is found the search for Tk starts from the parent directory, so tk9.1b1/generic/tk.h is never checked, and Tk is only found if its directory is named tk$useversion; the empty Tk directory then gives "not table of contents". Proposed fix in branch man2html-find-tk-generic: try both subdirectories for each search root. make html then works with tcl9.1b1/tk9.1b1; the output for a checkout layout is unchanged. Related: [7dc0420245] (branch man2html-tk-beside) is about the opposite case, an unrelated Tk tree found next to the source directory. Both change how tcltk-man2html.tcl finds Tk, in different places, so the branches can be merged together. | ||||
