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