[fpc-pascal] Docs - structural change

[Tomas Hajny]

On 2026-09-10 14:01, Marco van de Voort via fpc-pascal wrote:
> Op 10-9-2026 om 10:12 schreef Tomas Hajny via fpc-pascal:
>>> As I understood it, the IDE uses CHM files, but all this is disabled 
>>> for CHM.
>>> So we should be OK.
>> 
>> IDE uses whatever is supplied / configured by the user as long as it 
>> is one of the supported formats (that includes HTML). If the HTML 
>> format of our docs wasn't supported any longer, we should let our 
>> users know.
> 
> Afaik CHM is preferred since about 2.4.4/3.0.0. I don't have any info 
> if it works at all anymore and all the umpteen workarounds for lfn/path 
> separators etc.

Apart from both of us knowing that CHM should be preferred, where 
exactly is it documented as such? File readme.txt supplied with the last 
release states about the IDE: "context sensitive help supports help 
files in HTML, Windows HLP and Borland TPH format". Our documentation 
(user manual - user.pdf) states in the chapter related to IDE:
------
The IDE contains a help system which can display the following file 
formats:
- TPH The help format for the Turbo Pascal help viewer.
- INF The OS/2 help format.
- NG The Norton Guide Help format.
- HTML HTML files
=======

And a bit later: "The Free Pascal documentation in HTML format can be 
added to the IDE’s help system. This way the documentation can be viewed 
from within the IDE."

And while you ask - as far as I can see, the HTML version still seems to 
work correctly in the IDE.

Tomas