Re: Best tool to create help file from Delphi XMLDoc comments

On 2006-06-13, Serge Dosyukov (Dragon Soft) <serge> wrote:
long story short... I am back to review help gen tools again.

Source: Delphi code with XMLDoc/JavaDoc/PasDoc formated comments along with
class declarations
Destination: PDF/HTML/HLP documentation
Nice-to-have:
* one-click import/resync
* layout and color schema design
* WYSIWYG editor for topics and index editing

Suggestions? comments?

FPC fpdoc.

- scans sourcecode to XML template
- GUI editor (tag based, not WYSIWYG) creates XML with all doc data.
- both templates can be combined.
- afaik reports which idents are not documented can be added.
- .hlp not ready yet (RTF output should be done, I'd prefer to have a
internal hlp generator too)
- PDF goes via LaTeX, which could be model for RTF output.
- htm(l) output directly (htm is 8.3 compliant)
- afaik no other helpers than latex currently.
- open source (GPL), mallable, modifyable, but also a bit rough (cmdline for
generation). Delphi compilability untested, but can't be THAT much work.

Output examples: the "standards units" book on http://www.freepascal.org/docs.html
(html+pdf). The focus is still a bit on the PDFs.

.