sweeten-docco v0.3.3

Sweeten-Docco

Sweeten docco output with syntax-highlighted JSDoc & Codo tags.

Check out the coffeescript for the above sample, also used by our test suite.

Features

• Detects JSDoc & Codo tag names (plus a bonus 'api' tag).
• Supports JSDoc & Codo param styles (@param {Type} name desc or @param [Type] name desc).
• Lists param names before types in output for convenience (but allows either style in the source).
• Automatically adds linebreaks between tag statements (no need to append spaces for Markdown!).
• Tested on Linux and Mac OS X.

Try Sweeten-Docco if you...

1. Like docco's style of Literate Programming.
2. Like doc-tags for specifying details (param types, return values, api status, etc).
3. Want to combine these documentation styles!

Installing

Just add sweeten-docco to your project. With curl:

Or npm:

Npm is recommended for easy updates with npm update sweeten-docco.
A global install is also possible with npm install -g sweeten-docco, for convenient command-line use.

Usage

1. Generate docco as you usually do, eg:

2. Run sweeten-docco from your project directory: