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
_______________________________________________
fpc-devel maillist - [email protected]
http://lists.freepascal.org/mailman/listinfo/fpc-devel
