specify input file + output file

[boneskull]

Maybe related to #40 but regardless, I want to read path/to/foo.js and have it output into a file README.md.

[mrjoelkemp]

+1 for having more granular control.

Throwing some ideas out there for possible implementations:

1. Make the --output option more flexible to allow the user to specify an output directory or output file.
   • jsdox file.js -o readme.md
   • jsdox src/ -o docs/
   • jsdox file1.js -o docs/ (need to either prevent this case or assume this will create docs/file1.md)
2. Have a new option that pipes the generated MD to stdout allowing a redirect to a custom file.
   • cat file1.js | jsdox -X > readme.md
   • -X is somewhat arbitrary (replicating JSDoc's outputting of the AST to stdout) and open to bikeshedding.

[psq]

sounds good to me.

In the first case, only missing case is jsdox file.js -o readme.md, the other 2 should already work today.