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

[Sven Barth]

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)

Regards,
Sven