Path: ...!2.eu.feeder.erje.net!feeder.erje.net!eternal-september.org!feeder3.eternal-september.org!news.eternal-september.org!.POSTED!not-for-mail
From: Harald Oehlmann <wortkarg3@yahoo.com>
Newsgroups: comp.lang.tcl
Subject: Re: Tcl 9 Build failure using Visual Studio 2022
Date: Mon, 14 Oct 2024 20:59:09 +0200
Organization: A noiseless patient Spider
Lines: 71
Message-ID: <vejplu$1aedk$1@dont-email.me>
References: <ve91l8$37ono$1@dont-email.me> <ve9uf1$3c89g$1@dont-email.me>
 <vega38$ld2e$2@dont-email.me> <vejbrj$16ppd$1@dont-email.me>
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8; format=flowed
Content-Transfer-Encoding: 8bit
Injection-Date: Mon, 14 Oct 2024 20:59:10 +0200 (CEST)
Injection-Info: dont-email.me; posting-host="04dd0001cee849d7c4104f7b957f4c30";
	logging-data="1391028"; mail-complaints-to="abuse@eternal-september.org";	posting-account="U2FsdGVkX1+fZeZe8g2V3uX4kpI65BAr"
User-Agent: Mozilla Thunderbird
Cancel-Lock: sha1:m7IAqqSEkr3D7OcuKplG47SeUh4=
In-Reply-To: <vejbrj$16ppd$1@dont-email.me>
Content-Language: en-GB
Bytes: 3724

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