add filename option to define custom filename 😉

[voronianski]

This changes are related to #317

[keithamus]

Seems a little excessive to have 2 CLI options to set 1 thing. Surely you're either going to set a custom title or not right?

[voronianski]

@keithamus I think that both options are necessary as they are not reliable on each other.

[keithamus]

Hmm, I'd like @jashkenas to pick this one up. I'm still not sold on adding 2 new CLI options, personally.

[voronianski]

@keithamus @jashkenas I'll provide some use cases:

• option --filename from CLI will work fine only for one file at once
• option --useTitle provides flexibility for such CLI use scenario when you need to generate docs for several files with custom output filenames at once

[jashkenas]

Using the title as a filename isn't nice, or desirable. My Fancy Title.html is a gross file name.

--filename, as you point out, only works for one file at a time, making it a lousy command-line option.

Let's not.

[voronianski]

@jashkenas that's sad :(

I could agree that --useTitle could be very subjective for my own use case but at least such option as --filename should be present here.

[Mouvedia]

I need --filename.