readthis takes block comments in specified .coffee or .js file(s) and outputs them in one file or on stdtout, passing through all other files types. End of story. I use it to document code in free-form API docs.

npm install readthis
6 downloads in the last week
12 downloads in the last month


Here's how it works:


npm install -g readthis


To read a bunch of files to dump to stdout:

readthis ./some/glob/patterns/**.coffee ../bleh.js ~/code/somethingelse.js 

To read a bunch of files to dump in one file:

readthis ./some/glob/patterns/**.coffee ../bleh.js ~/code/somethingelse.js -o


In all your .coffee's and .js'es, leave yourself notes using inline comments, and use pure markdown to document your code in block comments.

npm loves you