weizhu/yuidoc forked from yui/yuidoc

yuidoc README
yuidoc is a set of tools to generate the API documentation for the JavaScript
in the YUI library.  The docs are derived completely from JavaDoc style
comment blocks; no attempt is made to understand the javascript itself.
yuidoc requires Python 2.3+ with the following extensions:
    simplejson - for reading and writing json
    cheetah    - for generating the html docs
    pygments   - for colorizing the source
The code for yuidoc is provided under a BSD license:
    https://developer.yahoo.net/yui/license.html
Project home page:
    https://developer.yahoo.com/yui/yuidoc/
    
Source code:
    https://github.com/yui/yuidoc
Issue tracker:
    https://yuilibrary.com/projects/yuidoc
    
Files:
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
README
    This file
CHANGES
    The change log
INSTALL
    Installation instructions
KNOWN_ISSUES
    Known issues and workarounds.
TAGS
    Supported tags
license.txt
    Open source license details.
bin/yuidoc_parse.py
    The comment block parser.  Parses all javascript files in the the specified 
    directories and outputs a single file containing a json structure of the 
    parsed documentation.
bin/yuidoc_highlight.py
    Colorizes the script source
bin/yuidoc_generate.py
    Reads the json output from parser.py and generates HTML docs.
bin/yuidoc.py
    Wrapper for yuidoc_parse, yuidoc_highlight, and yuidoc_generate
bin/example.sh 
    An example shell script to run both the parser and generator on a src tree
bin/example.bat
    An example batch for for DOS/Windows
ext
    External required packages, provided for convenience