Am 11.10.2024 um 03:19 schrieb Michael Soyka:

On 10/10/2024 1:07 PM, Michael Soyka wrote:

I've downloaded the tcl900-src.zip file from SourceForge and am trying
to build it using the "buildall.vc.bat" script with Visual Studio
2022. Other than defining INSTALLDIR, I've changed nothing.  The
executables and packages appear to build without error but not the
help files which fail like so:

: make-manpage-section: not table of contents.
NMAKE : fatal error U1077: 'win\Debug_VC1941\tclsh90.exe win\..
\tools\tcltk-man2html.tcl "--htmldir=win\Debug_VC1941\html"' : return
code '0x1'
Stop.
*** BOOM! ***
DONE!

Note that I've shortened the paths in the above error message for
clarity.

Can anyone help?

-mike

To answer my own question, the work-around, at the moment, is to not
build the docs.  This means not using the shell script but invoking
nmake directly:

  nmake -nologo -f makefile.vc release
  nmake -nologo -f makefile.vc install

This allows me to test my apps using 9.0.  The docs issue can be
addressed later.

Your observation is correct.
On the other side, if the help workshop is available, it works. I always
test this. The result is semi-optimal anyway...

Thanks,
Harald

--- SoupGate-Win32 v1.05
* Origin: fsxNet Usenet Gateway (21:1/5)

Am 14.10.2024 um 17:03 schrieb Michael Soyka:

On 10/13/2024 7:14 AM, Harald Oehlmann wrote:

Am 11.10.2024 um 03:19 schrieb Michael Soyka:

On 10/10/2024 1:07 PM, Michael Soyka wrote:

I've downloaded the tcl900-src.zip file from SourceForge and am
trying to build it using the "buildall.vc.bat" script with Visual
Studio 2022. Other than defining INSTALLDIR, I've changed nothing.
The executables and packages appear to build without error but not
the help files which fail like so:

: make-manpage-section: not table of contents.
NMAKE : fatal error U1077: 'win\Debug_VC1941\tclsh90.exe win\..
\tools\tcltk-man2html.tcl "--htmldir=win\Debug_VC1941\html"' :
return code '0x1'
Stop.
*** BOOM! ***
DONE!

Note that I've shortened the paths in the above error message for
clarity.

Can anyone help?

-mike

To answer my own question, the work-around, at the moment, is to not
build the docs.  This means not using the shell script but invoking
nmake directly:

   nmake -nologo -f makefile.vc release
   nmake -nologo -f makefile.vc install

This allows me to test my apps using 9.0.  The docs issue can be
addressed later.

Your observation is correct.
On the other side, if the help workshop is available, it works. I
always test this. The result is semi-optimal anyway...

Thanks,
Harald

Thanks for your reply.  I've had past experience with the help workshop
but when I upgraded to Windows 10, it never occurred to me to download
it again- who knew?

Anyway, since the Tcl/Tk sources come with man-pages in nroff format and
the unix makefile creates HTML pages, it occurred to me to port those makefile targets to makefile.vc.  Thus far, I've made the HTML help
files for both Tcl and Tk but each has its own index.html file and the
build process does not merge them.  That's the next mystery.

-mike

The help files are only merged, if:
- tcl and tk source is in a common sub-folder and there is no other
tcl/tk subfolder in the same directory.
- cd tcl9.0.0\win
- nmake -f Makefile.vc
- nmake -f Makefile.vc htmlhelp
Will build both html help sets and the unified index file. Then, the
call to the help workshop fails, but the files are in
win\Release_VCxxxx\html

I tried to put info on the help system here:

https://core.tcl-lang.org/tcl/wiki?name=How+to+edit/test+tcl+man+pages&p

Any help appreciated,
Harald

--- SoupGate-Win32 v1.05
* Origin: fsxNet Usenet Gateway (21:1/5)

Thank you for the Wayback machine reference and links.  I've heard of
this site before but keep forgetting about it.

By coincidence, a few days ago I looked at some old system backups, my
own personal Wayback machine, and found the same files you've listed
above.  I installed the htmlhelp app and tried to build the help files
for version 9 and encountered two problems.

First, the makefile.vc references a file named contents.htm which the
help compiler couldn't find (error HHC5003).  Nonetheless, it created
the .chm file but when I launched it, a message popped-up about a
missing Internet Explorer DLL file:  //ieframe.dll/dnserrordiagoff.htm#

The build process does create an index.htm file but if I blindly replace contents.htm with index.htm in the makefile, the same errors occur
(HHC5003- can't compile index.htm).

Truth be told, I'm good with the HTML pages but the above errors irk me
and so this is still a work in progress (in my spare time).

Dear Michael,
for me, the make target "htmlhelp" runns without issues with installed
help compiler and MS-VS2015.
But the resulting file TclTk90.chm shows an error message in the main
widget planes (not an error box) when started:
Vergewissern Sie sich, dass die Webadresse
//ieframe.dll/dnserrordiagoff.htm# stimmt.

says something like: Be shure that the web address ... is correct.

There is only a search tab on the left side, no contents ans items.

The current maintainer Ashok has abandoned this type of help.
I can imagine, that it will be removed soon.
Even Microsoft does not see any future.

Nevertheless, I use Ashoks TCL 8.6.10 chm file (from his web site) on a
daily basis for quick offline reference - one file - all manuals !

Take care,
Harald

no access on this page:

--- SoupGate-Win32 v1.05
* Origin: fsxNet Usenet Gateway (21:1/5)

Here's what I use to build the CHM file for TCL/TK 9.0: http://paste.tclers.tk/6027

--- SoupGate-Win32 v1.05
* Origin: fsxNet Usenet Gateway (21:1/5)

I abandoned the CHM format because of sporadic crashes in htmlhelp when
content was changed. Just minor edits to content would make the crashes disappear (or reappear!). It really is an obsolete format so I do not
plan on resurrecting it.

Brian's batch file is a workaround for anyone still desiring that format.

/Ashok

On 11/2/2024 6:19 AM, Michael Soyka wrote:

On 11/01/2024 3:22 PM, bohagan wrote:

Here's what I use to build the CHM file for TCL/TK 9.0:
http://paste.tclers.tk/6027

Brian,

Thanks for the script (and web site capability)- it told me what's wrong
with the project makefile makefile.vc.

Makefile.vc uses a "inline file" to create HHPFILE.  However, it lists
the files with a .htm extension but the files being referenced have
a .html extension.  When I corrected the extensions and changed "contents.htm" to "index.html", the build succeeds.  Case closed.

I will open a ticket for this.

-mike

--- SoupGate-Win32 v1.05
* Origin: fsxNet Usenet Gateway (21:1/5)

Forgot to add, I'll make the change you suggested in any case.

On 11/2/2024 6:19 AM, Michael Soyka wrote:

On 11/01/2024 3:22 PM, bohagan wrote:

Here's what I use to build the CHM file for TCL/TK 9.0:
http://paste.tclers.tk/6027

Brian,

Thanks for the script (and web site capability)- it told me what's wrong
with the project makefile makefile.vc.

Makefile.vc uses a "inline file" to create HHPFILE.  However, it lists
the files with a .htm extension but the files being referenced have
a .html extension.  When I corrected the extensions and changed "contents.htm" to "index.html", the build succeeds.  Case closed.

I will open a ticket for this.

-mike

--- SoupGate-Win32 v1.05
* Origin: fsxNet Usenet Gateway (21:1/5)