[fpc-devel] Errors with make rtl.chk on Windows

[Michael Van Canneyt]

On Fri, 2 Dec 2011, Sven Barth wrote:

> Am 02.12.2011 17:21, schrieb Michael Van Canneyt:
>>> 
>>> This means that we can document platform-specific items in additional
>>> files, which are automatically merged with the other descriptions. The
>>> description file specifications can be extended by a platform
>>> attribute, so that problems arising from multiple (platform specific)
>>> descriptions can be eliminated. E.g.:
>>> <description file="sysutils.xml"/>
>>> <description file="linux-sysutils.xml" platform="linux,unix"/>
>>> <description file="win-sysutils.xml" platform=windows/>
>> 
>> I don't see the point of this. Why not simply add them to the
>> description file sysutils.xml ?
>> 
>> <element> tags for which no source file identifier exists are discarded
>> anyway.
>> 
>> If anything needs to be done at all, I see more use in adding a
>> 'platform' tag to the element tags themselves; That would give the
>> documentation generator useful information which it can use. In fact,
>> the 'platform' directive should in the first place be in the sources
>> themselves, where it will be picked up by the scanner/parser - as per
>> the remark of Marco.
>
> Out of curiosity: How could/would one create one documentation of source 
> which supports multiple platforms, but where there are identifiers that are 
> only available for some platforms? (like our RTL)

You currently can't as long as the source files are different.

And even with the same source file it is difficult, since the parser will 
always parse only one branch from an IFDEF.

{$IFDEF WINDOWS}
   THANDLE = Handle;
{$ELSE}
   THANDLE = Pointer;
{$endif}

Cannot be parsed correctly. Same for library units with different calling conventions etc.

Michael.