有没有一种工具取代javadoc的东西,而不是正常的JavaDoc的HTMLish语法更多的Wiki风格的语法?是否有一个使用维基语法的javadoc替换?
我的一个问题是我大部分都是以源代码的形式读取JavaDoc。即使对于外部库,我也尝试添加源代码,以便从我的IDE中导航到源代码,检查入口点上方的文档以及下面的代码。
另一个问题是,像列表和代码示例这样的东西很难写,特别是如果你的IDE坚持要在每一行放上星星。我想看到的东西,用一种wiki语法与至少以下特点:
- 名单
- 代码块
- 交联方法/类
有还有很多更好的东西,但我相信这些都是必需品。
有谁知道这样的工具?
代码块都差不太多与'{@code}'。我认为'{@link}'很适合链接到会员和类型。 – 2009-09-22 00:06:19
当你在考虑维基风格的显示时,如果你可以编辑维基风格,并且将它推回到评论中,那将是非常不错的。我怀疑这是多少要求。 – Carl 2009-09-22 02:28:52