merging help files

[linus]

Hello,

hope developer chat is the right place to ask this:

I am working on a help file for/from an UDF (au3Irrlicht2). Found good infos for this in the forum, so I have nearly finished the technical part to include a stand-alone .chm into next release of this UDF.

But I was wondering about the "autoItHelp.exe" in au3 installation dir - seems to merge both standard .chm's, so maybe a mechanism to add also a third "non-official" .chm(?).

Unfortunately I cannot find anything about this .exe in forum nor by googlin'. What is this exactly - a compiled .au3? Separate tool?

Some info and/or link would be very nice + helpful.

Thanks in advance!

[SyDr]

http://www.autoitscript.com/autoit3/files/archive/autoit/

autoit-docs-v3.3.6.1-src.exe

\docs\autoit\english\AutoItM.hhp

[OPTIONS]

Compatibility=1.1 or later

Compiled file=AutoIt.chm

Contents file=AutoItM.hhc

Default Window=$global_TP

Default topic=html/introduction.htm

Display compile progress=Yes

Error log file=_errorlogM.txt

Full-text search=Yes

Index file=AutoItM.hhk

Language=0x809 English (United Kingdom)

Title=AutoIt Help File

[WINDOWS]

$global_TP="AutoIt Help","AutoItM.hhc","AutoItM.hhk","","",,,,,0x63520,,0x102806,[0,0,640,480],0x80000,,,,,,0

[MERGE FILES]

AutoIt3.chm

UDFs3.chm

...

[linus]

You are pointing out the "AutoIt.chm", but I was asking for the "AutoItHelp.exe" - it's in same dir and merges the autoit.chm and UDFs3.chm. That's the mechanism I would like to understand / use.

Thanks anyway!

[SyDr]

1) Rename or move or delete AutoIt.chm

2) Try run AutoItHelp.exe

To merge additional help files you need:

1) Edit AutoItM.hhp

[MERGE FILES]

AutoIt3.chm

UDFs3.chm

Test.chm

2) Edit AutoItM.hhc

<object type="text/sitemap">

<param name="Name" value="AutoIt3.chm::/AutoIt3 TOC.hhc">

<param name="Merge" value="AutoIt3.chm::/AutoIt3 TOC.hhc">

</object>

<object type="text/sitemap">

<param name="Name" value="UDFs3.chm::/UDFs3 TOC.hhc">

<param name="Merge" value="UDFs3.chm::/UDFs3 TOC.hhc">

</object>

<object type="text/sitemap">

<param name="Name" value="Test.chm::/AutoIt3 TOC.hhc">

<param name="Merge" value="Test.chm::/AutoIt3 TOC.hhc">

</object>

3) Compile AutoItM.hhp

Result:

http://userpics.foto.tut.by/z/r/1000014988/test806356.jpg

[linus]

Damned, I have completely overseen there are three .chm's in the dir ... So the 'magic' of the AutoIt3Help.exe is simply to launch the merged (sometimes invisible ) autoIt.chm ...

Thanks for curing from blindness, and I think your explanations are useful for my purposes. By the way: very good style of explanation!

[Jos]

Damned, I have completely overseen there are three .chm's in the dir ... So the 'magic' of the AutoIt3Help.exe is simply to launch the merged (sometimes invisible ) autoIt.chm ...

Thanks for curing from blindness, and I think your explanations are useful for my purposes. By the way: very good style of explanation!

nope,

The AutoIt.chm is just a "master" helpfile that has pointers [MERGE FILES] to the AutoIt3.chm and UDFs3.chm. The sole purpose is that we can maintain the core AutoIt3 helpfile seperate from the UDF helpfile.

The purpose of AutoIt3help.exe is to open the Helpfile at the proper location with the supplied keyword.

Jos

Edited August 12, 2010 by Jos