XMLDoc Delphi source code documentation generation

Question

I assume that XML and Delphi Documentation Guidelines are becoming the de-facto standard for source-code documenting comments. That is good. The bad thing is that I cannot find any Delphi documentation generator (free or commercial) that fully supports these standards (for example Doc-O-Matic Express does not support <list> tags).

The question is: what XML documentation standards and Delphi source code XMLDoc documentation generators are ready to use now?

It's good apart from the bit where humans have to read and write XML! — David Heffernan
– David Heffernan, Commented Feb 7, 2011 at 20:37
@David: No, you quickly get accustomed to writing XML. It is something like writing Pascal :) — kludg
– kludg, Commented Feb 8, 2011 at 1:16
@Serg I have never got accustomed to writing XML. I suppose it is going to be easier for programmers to get it than for non-programmers. Personally I'm a huge fan of YAML. — David Heffernan
– David Heffernan, Commented Feb 8, 2011 at 9:20
IMHO XML is for human quick inspection only. Not for writing. It is too verbose and hampers reading too much. But a simple editor can go a long way — Marco van de Voort
– Marco van de Voort, Commented Feb 8, 2011 at 12:41
@Macro: I am talking about XMLDoc-style in-source documenting comments. I like to write them, and I don't want to use any WYSIWYG XML editor for it. I still think that currently Doc-O-Matic is the best choice to generate Delphi source code documentation, though I must say that my commitment to Doc-O-Matic "has cooled significantly" ;) — kludg
– kludg, Commented Feb 8, 2011 at 15:33

Community · Accepted Answer · 2017-05-23 12:20:38Z

4

(You are asking two questions. That's probably why you are getting no answers.)

On the tools front, take a look at these previously asked questions:

edited May 23, 2017 at 12:20

CommunityBot

11 silver badge

answered Feb 7, 2011 at 21:14

Leonardo Herrera

8,4065 gold badges40 silver badges69 bronze badges

Sign up to request clarification or add additional context in comments.

4 Comments

kludg Over a year ago

-1. The question is single, and the above is not an answer to it.

Leonardo Herrera Over a year ago

Well, your phrasing is somewhat strange. I thought you were asking for XML documentation standards and delphi source code XMLDoc generators. In the second link I provided you can find a tool for DelphiCodeToDoc which may or may not help you. Anyways, you are welcome.

kludg Over a year ago

DelphiCodeToDoc does not support XML at all.

Warren P Over a year ago

@Serg: It's open source. How hard would it be to add that to it? Not very hard, I bet.

albert · Accepted Answer · 2019-03-24 13:44:45Z

0

I would check these products:

doxygen
NDoc 3 (but maybe it requires access to .Net assemblies - then it will not work)

edited Mar 24, 2019 at 13:44

albert

9,2003 gold badges24 silver badges42 bronze badges

answered Mar 25, 2012 at 15:40

mjn

36.7k30 gold badges185 silver badges392 bronze badges

Collectives™ on Stack Overflow

XMLDoc Delphi source code documentation generation

2 Answers 2

4 Comments

Comments

Your Answer

Linked

Hot Network Questions

Collectives™ on Stack Overflow

2 Answers 2

4 Comments

Comments

Your Answer

Sign up or log in

Post as a guest

Linked

Related