Natural Docs is an open-source, extensible, multi-language documentation generator. You document your code in a natural syntax that reads like plain English. Natural Docs then scans your code and builds high-quality HTML documentation from it.Source: Natural Docs
Is anyone else out there using this package? If you were and stopped, how come? Just curious...
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).
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.
It actually does support JavaDoc, it just hasn't been released yet. You have to pull from CVS. For example, see here.