jashkenas/docco — pull request #86 by baoshan (2012-03-22 09:13:04+00:00)
Title: Minor tweaks for easier batch processing

Three minor modifications have been made to docco to:

1. Make batch processing easier. Repository-wide document generation and automated syncing between sources & documents become possible.
2. Make docco's original usage scenarios more friendly. Provide feedback when encountering unrecognized extension. Provide the most demanded options (custom stylesheet link and output directory).

There're three commits included in this pull request:

1. Provide user friendly information when encountering unrecognized extension.
2. Embed a meta tag in the template serving as a signature of files generated by docco.
3. Provide -c (--css) option to overwrite stylesheet link, and -o (--out) option to overwrite 'doc' folder.

All the modifications didn't introduce a new line to docco.coffee. And only add a meta tag to the template.

Usage:

```
docco src/*
```
will provide warning on unrecognized files:

```
Unknown Type: src/source_of_unknown_extension.xyz
docco: src/docco.coffee -> docs/docco.html
```

And:

```
docco --css 'http://static.yourdomain.com/stylesheets/docco.css' src/*
```
will use the specified css file in the generated html file.

And:
```
find . -type f -exec grep -l -i '' '{}' ';'
```
can find the files generated by docco.

Please have a review.