XMLDoc Delphi源代码文档生成

Question

我假设XML和Delphi Documentation Guidelines已经成为源代码文档注释的事实标准。这很好。坏的是，我无法找到任何完全支持这些标准的Delphi文档生成器（免费或商业），例如Doc-O-Matic Express不支持<list>标签。

问题是：哪些XML文档标准和Delphi源代码XMLDoc文档生成器现在可以使用？

- kludg

---

@David：不，你很快就会习惯编写XML。这有点像写Pascal :) - kludg

@Serg 我从来没有习惯写XML。我想程序员比非程序员更容易理解它。个人而言，我是YAML的忠实粉丝。 - David Heffernan

@宏：我说的是XMLDoc风格的内部注释文档。我喜欢写它们，而且我不想使用任何所见即所得的XML编辑器。尽管我必须承认，我对Doc-O-Matic的承诺“已经明显冷却”，但我仍然认为目前它是生成Delphi源代码文档的最佳选择。 - kludg

@Serg：除了支持List标签之外，doc-o-matic符合你的要求吗？ - Warren P

@Warren：这取决于你想要什么。确实，doc-o-matic是用于Delphi源代码的最佳文档生成器，你可以使用它，考虑到支持的XML标签列表（如果使用XMLDoc样式）。 - kludg

Answer 1

(您提出了两个问题。这可能是您没有得到答案的原因。)

在工具方面，请查看以下之前提出的问题：

• XMLDoc 的 IDE 插件
• 类似于 javadoc 或 c# xml doc 的 Delphi 代码文档

- Leonardo Herrera

---

问题是单一的，上面的内容并不是它的答案。 - kludg

嗯，你的措辞有些奇怪。我以为你在询问XML文档标准和Delphi源代码XMLDoc生成器。在我提供的第二个链接中，你可以找到一个名为DelphiCodeToDoc的工具，它可能会对你有所帮助。无论如何，不用谢。 - Leonardo Herrera

DelphiCodeToDoc完全不支持XML。 - kludg

@Serg：这是开源的。把它加进去有多难？我打赌不会很难。 - Warren P

Answer 2

我会检查这些产品：

• doxygen
• NDoc 3（但可能需要访问 .Net 程序集 - 那么它将无法工作）

- mjn