我试图将我们的数据库软件包更完整地记录为API。我们想要的是类似PL / SQL的JavaDocs。我已经看到了一些工具(pldoc,plsqldoc),但想从使用它们的人那里知道它们之间的比较。

最佳答案

我使用过PlDoc并发现它真的很好。我没有使用任何其他工具,所以无法比较。我发现PlDoc做得很好。我想要一些更高级的功能,所以我构建了自己的工具,该工具为PlDoc添加了扩展以获取更多标签。另外,我不仅使用它来做文档,还使用一些PlDoc标签(例如@private)生成了包头。

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

07-26 01:53