w8jcik / docco

Literate Programming can be Quick and Dirty.

Home Page:http://jashkenas.github.com/docco/

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

 ____
/\  _`\
\ \ \/\ \        ___         ___         ___         ___
 \ \ \ \ \      / __`\      /'___\      /'___\      / __`\
  \ \ \_\ \    /\ \ \ \    /\ \__/     /\ \__/     /\ \ \ \
   \ \____/    \ \____/    \ \____\    \ \____\    \ \____/
    \/___/      \/___/      \/____/     \/____/     \/___/


Docco is a quick-and-dirty, hundred-line-long, literate-programming-style
documentation generator. For more information, see:

http://jashkenas.github.com/docco/

Usage
-----

Usage: docco [options] FILES

  Options:

    -h, --help             output usage information
    -V, --version          output the version number
    -l, --layout [layout]  choose a built-in layouts (parallel, linear)
    -c, --css [file]       use a custom css file
    -o, --output [path]    use a custom output path
    -t, --template [file]  use a custom .jst template
    -b, --blocks           parse block comments where available
    -m, --markdown         output markdown
    --marked [file]        use custom marked options
    -e, --extension [ext]  use the given file extension for all inputs
    -L, --languages [file] use a custom languages.json

---

Building and Testing
--------------------

Install (on Ubuntu 12):

( as root )
    apt-get install coffeescript

( as user )
    npm install
( See also: harvesthq/chosen#508 )
    cake.coffeescript build
    cake.coffeescript doc
    cake.coffeescript test


When you run
    cake.coffeescript install
you must make sure to install the commander package as well:
    npm install commander -g



Building and Testing (original, outdated info):
-----------------------------------------------

    npm install
    cake build
    cake test



===================================================================

This fork supports JSDoc style comments and highlights declared parameters.

Example:

/**
 * @description Lolify someone's name
 * @param {String} name A person's name
 */
function lolify(name) {
   return 'OH HAI ' + name + ' KTHXBAI';
}

About

Literate Programming can be Quick and Dirty.

http://jashkenas.github.com/docco/

License:MIT License


Languages

Language:CSS 52.0%Language:CoffeeScript 42.1%Language:Makefile 2.1%Language:Shell 1.9%Language:C 0.4%Language:JavaScript 0.4%Language:TeX 0.3%Language:Java 0.3%Language:Scala 0.2%Language:Python 0.2%Language:Ruby 0.1%