Hi,

I am trying to build the chm help files (rtl, fcl, and ref) from source (to use them with Lazarus) and cannot find find them anywhere. I have found downloads of ready made chm files for rtl and fcl but I don't know how to build them myself and also I am missing for example ref.chm (and maybe others too) which Lazarus is trying to open when pressing F1 on Pascal keywords.

IMHO there should be a top level makefile target to easily build *all* of them at once (btw: the same criticism [toplevel makefile target] applies to Lazarus as well but at least there I can easily find the folder with the lcl docs in the source tree)

Maybe I am missing something completely obvious but I just can't find it and neither google nor the wiki was of much help (I don't even know what exactly to search for)

Bernd

The chms of the unit references are built as a courtesy by Marco.

Maybe I am missing something completely obvious but I just can't find it and neither google nor the wiki was of much help (I don't even know what exactly to search for)

The sources of the docs are in subversion, just like everything else:

http://svn.freepascal.org/svn/fpcdocs/trunk

As far as I know, this is documented in the WIKI. (which currently seems to be down).

To my knowledge, the 'chm' Makefile target in that directory builds the fcl and rtl docs as CHM, but not the reference manuals. So pressing F1 on a pascal keyword will still not show anything.

Michael.

In our previous episode, Bernd said:

The fpcdocs repository, run the "fixdocs.sh" scripts. Afaik for the lazarus there is no "blind" script. The dependencies are the same as html building. (latex,tex4ht) and fpdoc (I always use trunk when I can, sicne usually a few more small things are fixed )

There is the buildhtml.sh script, but some parameters and environmental variables need to be set. (CSS location, fpcdocs directory and HTMLFMT to CHM)

IMHO there should be a top level makefile target to easily build *all* of them at once (btw: the same criticism [toplevel makefile target] applies to Lazarus as well but at least there I can easily find the folder with the lcl docs in the source tree)

There is a toplevel shellscript. Should be close enough. I never committed the lazarus one (which is much shorter, since it only parameterizes an existing script) because it had hardcoded references to my dir layout.

Maybe I am missing something completely obvious but I just can't find it and neither google nor the wiki was of much help (I don't even know what exactly to search for)

It is not documented, but it is not a secret either.

Marco van de Voort wrote

The fpcdocs repository, run the "fixdocs.sh" scripts. Afaik for the lazarus there is no "blind" script.

There are lots of blind scripts for lazarus help building, although its been a long time since I worked on them, so I don't know if they still work blindly:

cd lazarus/docs/html

MacBook-de-Felipe-Monteiro-de-Carvalho:html felipe$ ls -l total 2584
-rw-r--r-- 1 felipe staff 687 5 Jan 2010 Makefile -rw-r--r-- 1 felipe staff 497 2 Out 16:47 README.txt -rw-r--r-- 1 felipe staff 306 5 Jan 2010 build_chm.bat -rwxr-xr-x 1 felipe staff 189 5 Jan 2010 build_chm.sh -rwxr-xr-x 1 felipe staff 1030 5 Jan 2010 build_gtkintf_html.sh -rw-r--r-- 1 felipe staff 274 5 Jan 2010 build_html.bat -rwxr-xr-x 1 felipe staff 190 5 Jan 2010 build_html.sh -rw-r--r-- 1 felipe staff 1623 8 Nov 21:17 build_lcl_docs.lpi -rwxr-xr-x 1 felipe staff 3048 12 Ago 09:22 build_lcl_html.sh -rw-r--r-- 1 felipe staff 2253 8 Nov 21:17 fpdoc.css ...

In our previous episode, Felipe Monteiro de Carvalho said:

There are lots of blind scripts for lazarus help building, although its been a long time since I worked on them, so I don't know if they still work blindly:

Build_chm* are for the tool that the lpi is for. I never got them to work, so that is not how the current LCL files are generated (those are generated via build_lcl_html.sh).

Regenning chms is on my list for this week. I have to re-setup the procedure since I reinstalled my laptop.