【问题标题】:XMLDoc Delphi source code documentation generationXMLDoc Delphi 源代码文档生成
【发布时间】: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


【解决方案1】:

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

在工具方面,看看这些以前提出的问题:

【讨论】:

  • -1。问题是单一的,以上不是它的答案。
  • 嗯,你的措辞有点奇怪。我以为您是在询问 XML 文档标准和 delphi 源代码 XMLDoc 生成器。在我提供的第二个链接中,您可以找到一个 DelphiCodeToDoc 工具,它可能对您有帮助,也可能对您没有帮助。无论如何,不​​客气。
  • DelphiCodeToDoc 根本不支持 XML。
  • @Serg:它是开源的。将其添加到其中有多难?不是很难,我敢打赌。
【解决方案2】:

我会检查这些产品:

  • doxygen
  • NDoc 3(但也许它需要访问 .Net 程序集 - 那么它就不起作用了)

【讨论】:

    猜你喜欢
    • 2014-03-21
    • 2022-12-15
    • 2015-05-07
    • 2010-09-27
    • 2011-11-21
    • 1970-01-01
    • 2023-03-13
    • 2014-12-19
    • 2012-10-02
    相关资源
    最近更新 更多