[fpc-devel] FPC CHM files

[Mark Morgan Lloyd]

Marco van de Voort wrote:

> Once:
> - install latex
> - install tex4ht (nowadays just from package, in the past this was torture)

I notice that tex4ht is mandated by various things including OpenWRT, 
which provides an incentive for mainstream distreaux to get it right.

> Everytime:
> - with a full snapshot of FPC available run fpcdocs/fixdocs.sh  with the sources of FPC at
>   ../fpc 
> - Switch to lazarus
> - make sure all xml docs for all units exists. This usually takes most time.
> - Check location of fpdoc dir in build_lcl_chm.sh  it needs to find the
>   generated FPC docs for cross referencing.
> - run  doc/html/build_lcl_chm.sh   

I wonder if I could ask a related question. A year or so ago I was 
playing around, trying to see if I could generate a list of which 
version of FPC gained each function, and trying to generate a permuted 
index to help answer the "how do I" FAQs. I ran into various problems 
which gave me the impression that the raw help file data required the 
utilities in the matching FPC version: is that reasonable, or should the 
format from 2.0.0 onwards be absolutely invariant?

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

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