[fpc-devel] Added new target to fpmake

[Michael Van Canneyt]

On Sat, 27 Nov 2010, Darius Blaszyk wrote:

>>> I've been thinking about the folder structure for fpdoc xml files.
>>> Analog to bin and example files I would like to have the xml files in
>>> the default location called fpdoc. The output will be sent to the folder
>>> called docs. From where they can be installed. Of course the locations
>>> should be overidable.
>>
>> That concept seems OK to me.
>> Maybe --descr-folder and --doc-folder options need to be made then.
>>
>>> Regarding Marco's comment on Mantis however I'm not sure it will be
>>> possible to link xml and sourcefiles automatically, therefore I'm not
>>> sure it could work with a default fpdoc folder. Some comments would be
>>> appreciated.
>>
>> ? Not sure I understand wat you mean here. Marco's remark is about order of the units.
>> What does that have to do with linking XML and source automatically ?
>
> --doc-folder has been implemented. --descr-folder not yet, as we need to
> reach consensus on how to handle order dependency of fpdoc

Well, fpmake contains the dependencies of the units. 
Therefor you should be able to place the units in the correct order.
So my idea would be to enforce the order by looking at the dependencies.

All that is needed is to list the units that should be documented;
The engine can then look in the list of dependencies, and if there 
are dependencies found, they can be added first.

Michael.