pdoc /
| name | age | message | |
|---|---|---|---|
| |
.gitignore | ||
| |
CHANGELOG | ||
| |
LICENSE | Mon Apr 07 17:46:28 -0700 2008 | |
| |
PDoc.tmbundle/ | Mon Apr 28 13:05:25 -0700 2008 | |
| |
README.markdown | ||
| |
Rakefile | Mon Apr 14 16:46:11 -0700 2008 | |
| |
lib/ | ||
| |
output/ | Sat Apr 12 20:01:34 -0700 2008 | |
| |
templates/ | ||
| |
test/ | ||
| |
website/ |
README.markdown
PDoc
PDoc is an inline comment parser and JavaScript documentation generator written in Ruby. It is designed for documenting Prototype and Prototype-based libraries.
PDoc uses Treetop, a Ruby-based DSL for text parsing and interpretation, and it's own, ActionView-inspired, ERB-based templating system for HTML generation. Other documentation generators (for example, for DocBook XML) are planned.
Contrary to other inline documentation parser, PDoc does not rely on the JavaScript source code at all: it only parses the comments. This does imply being slightly more verbose when documenting the source code, but makes for a consistent, readable documentation and avoids the usual issues encountered when documenting highly dynamic languages.

