【发布时间】:2011-02-07 19:04:07
【问题描述】:
我假设 XML 和 Delphi Documentation Guidelines 正在成为源代码文档化 cmets 的事实标准。那很好。坏事是我找不到任何完全支持这些标准的 Delphi 文档生成器(免费或商业)(例如 Doc-O-Matic Express 不支持 标签)。
问题是:现在可以使用哪些 XML 文档标准和 Delphi 源代码 XMLDoc 文档生成器?
【问题讨论】:
-
这很好,除了人类必须读写 XML 的那一点!
-
@David:不,您很快就会习惯于编写 XML。这有点像写 Pascal :)
-
@Serg 我从不习惯编写 XML。我想程序员比非程序员更容易get。我个人是 YAML 的忠实粉丝。
-
恕我直言 XML 仅用于人工快速检查。不是为了写作。它太冗长,妨碍阅读太多。但是一个简单的编辑器可以走很长的路
-
@Macro:我说的是 XMLDoc 样式的源内文档 cmets。我喜欢编写它们,并且我不想为此使用任何所见即所得的 XML 编辑器。我仍然认为目前 Doc-O-Matic 是生成 Delphi 源代码文档的最佳选择,尽管我必须说我对 Doc-O-Matic 的承诺“已经显着降温”;)
标签: delphi documentation-generation