[Lazarus] Building help files: the nitty-gritty

[Mark Morgan Lloyd]

Mattias Gaertner wrote:

>>>> I still had to build lhelp manually.
>>> Check if you have local modifications. In trunk the makefile target
>>> bigide includes lhelp.
>> Same applies.
> 
> If you don't have a components/chmhelp/lhelp/lhelp after doing a "make
> bigide", then please report the bug.

I'll revisit that on a clean system as soon as I'm able.

>>>>> The docs have references to the RTL+FCL docs, which are outside the
>>>>> Lazarus sources and have references to programmers guide, which
>>>>> requires latex. The whole doc build chain has too many dependencies and
>>>>> need several minutes to build. That's not feasible for a simple make
>>>>> command.
>>>> So what's best to do here: download them as binaries and install where/how?
>>> Download the chm files and put them into "yourlazarus/docs/chm/".
>> OK, so I get 
>> ftp://freepascal.stack.nl/pub/fpc/dist/2.6.0/docs/doc-chm.zip and 
>> unpack. The .txt file says copy the files to docs/html which I'm 
>> assuming is wrong, so I end up with .chm (etc.) files in 
>> /usr/local/share/lazarus-trunk/docs/chm and the Lazarus IDE picks them 
>> up automatically.
> 
> Yes, the paths are a little bit confusing.

I've been working through this several times with the intention of 
putting Lazarus docs build (from source) plus FPC docs copy (from 
binaries) into my usual build/installation scripts, but am finding that 
the FPC (RTL etc.) stuff is only picked up intermittently. Is there a 
cache to be cleared somewhere or something comparable?

-- 
Mark Morgan Lloyd
markMLl .AT. telemetry.co .DOT. uk

[Opinions above are the author's, not those of his employers or colleagues]