代码之家 › 专栏 › 技术社区 › No AI now No AI ever

PL/SQL包内联文档

documentation-generation plsql oracle sql

7

No AI now No AI ever · 技术社区 · 17 年前

我正试图以API的形式更完整地记录我们的数据库包。我们想要的是类似javadocs for pl/sql的东西。我已经看到了一些工具(pldoc,plsqldoc),但我想从使用它们的人那里了解它们的比较。

2 回复 | 直到 17 年前

1

6

darreljnz 17 年前

我用过PLDOC,发现它非常好。我没有使用任何其他工具,因此无法比较。我发现PLDOC做的很好。我想要一些更高级的特性,所以我建立了自己的工具,为更多的标签添加了对pldoc的扩展。另外,我不只是用它做文档,我还使用一些pldoc标签(例如@private)生成包头。

我建议你先试试PLDOC,然后再调整那些不符合你需要的。它不需要花那么长时间来建立,所以尝试它不是一个巨大的时间投资。

2

kenneedham 17 年前

我一直在使用 NaturalDocs 几年来,我们发现它很容易安装和使用。它非常像javadocs,支持多种语言,尽管我只在pl/sql中使用过它。很容易配置,尽管我没有发现有必要去处理它。