Pl/SQL 包内联文档答案

【问题标题】：Pl/SQL Package Inline DocumentationPl/SQL 包内联文档
【发布时间】：2009-08-26 17:19:53
【问题描述】：

我正在尝试将我们的数据库包更完整地记录为 API。我们想要的是类似 JavaDocs for PL/SQL 的东西。我已经看到了一些工具（pldoc、plsqldoc），但想从使用它们的人那里了解它们的比较。

【问题讨论】：

标签： sql oracle plsql documentation-generation

【解决方案1】：

我使用过 PlDoc，发现它非常好。我没有使用任何其他工具，所以无法比较。我发现 PlDoc 在基础方面做得很好。我想要一些更高级的功能，所以我构建了我们自己的工具，为 PlDoc 添加了更多标签的扩展。此外，我不只是用它做文档，我还使用一些 PlDoc 标签（例如@private）生成我们的包头。

我建议您尝试 PlDoc，然后调整不符合您需求的任何内容。设置不需要那么长时间，因此尝试它不需要花费大量时间。

【讨论】：

【解决方案2】：

我已经使用NaturalDocs 几年了，发现它易于安装和使用。它很像 JavaDocs 并且支持多种语言，尽管我只在 PL/SQL 中使用过它。非常可配置，虽然我没有发现有必要摆弄它。

【讨论】：

如果没有您的回答，我可能不会找到这个特定的工具。虽然非常平易近人，但我认为我们的团队需要一个结构更严格的解决方案。谢谢！