Comments on: Who’s using Natural Docs? http://decafbad.com/blog/2005/12/11/whos-using-natural-docs It's all spinning wheels and self-doubt until the first pot of coffee. Thu, 20 Nov 2008 14:11:51 +0000 http://wordpress.org/?v=2.7-beta3-9771 hourly 1 By: Kodi http://decafbad.com/blog/2005/12/11/whos-using-natural-docs/comment-page-1#comment-3155 Kodi Mon, 12 Dec 2005 17:39:36 +0000 http://decafbad.com/blog/?p=794#comment-3155 <p>It actually does support JavaDoc, it just hasn't been released yet. You have to pull from CVS. For example, see <a href="http://cvs.sourceforge.net/viewcvs.py/naturaldocs/NaturalDocs/Modules/NaturalDocs/Parser/JavaDoc.pm?view=markup" rel="nofollow">here</a>.</p> It actually does support JavaDoc, it just hasn’t been released yet. You have to pull from CVS. For example, see here.

]]> By: l.m.orchard http://decafbad.com/blog/2005/12/11/whos-using-natural-docs/comment-page-1#comment-3154 l.m.orchard Mon, 12 Dec 2005 11:42:42 +0000 http://decafbad.com/blog/?p=794#comment-3154 <p>Brian: Well, as I understand it, Natural Docs is a <em>replacement</em> for something like JavaDoc. (or POD, or pydoc, or etc) It's trying for a more wiki-like or YAML-like syntax.</p> <p>That's definitely a downside to Natural Docs, though, if we were using Java in our project. We use Perl, but the ND syntax seems to complement POD a bit more than it replaces it.</p> Brian: Well, as I understand it, Natural Docs is a replacement for something like JavaDoc. (or POD, or pydoc, or etc) It’s trying for a more wiki-like or YAML-like syntax.

That’s definitely a downside to Natural Docs, though, if we were using Java in our project. We use Perl, but the ND syntax seems to complement POD a bit more than it replaces it.

]]> By: Brian Lalor http://decafbad.com/blog/2005/12/11/whos-using-natural-docs/comment-page-1#comment-3153 Brian Lalor Mon, 12 Dec 2005 11:23:46 +0000 http://decafbad.com/blog/?p=794#comment-3153 <p>It looks like a great solution for multiple languages, but I don't see that it also supports JavaDoc. JavaDoc has many benefits, and I would rather see Natural Docs either support JavaDoc comments, or somehow be able to include rendered JavaDoc output (or use another doclet to generate a compatible intermediary).</p> It looks like a great solution for multiple languages, but I don’t see that it also supports JavaDoc. JavaDoc has many benefits, and I would rather see Natural Docs either support JavaDoc comments, or somehow be able to include rendered JavaDoc output (or use another doclet to generate a compatible intermediary).

]]> By: Richard@Home http://decafbad.com/blog/2005/12/11/whos-using-natural-docs/comment-page-1#comment-3152 Richard@Home Mon, 12 Dec 2005 09:51:37 +0000 http://decafbad.com/blog/?p=794#comment-3152 <p>Thanks for the heads up on Natural Docs, I have been using phpDocumentor but this seems to be a great way to document projects that use a variety of languages (HTML, PHP, Javascript for example).</p> Thanks for the heads up on Natural Docs, I have been using phpDocumentor but this seems to be a great way to document projects that use a variety of languages (HTML, PHP, Javascript for example).

]]>