Why must --files be used when I'm using conf.json?

I’m passing -c conf.json to jsdoc2md:

jsdoc2md --template readmeTpl.hbs --no-cache -c doc/conf.json --files lib/* >> README.md

I’d like to include lib/* in doc/conf.json’s source.include below:

  "source": {
    "include": [
      "node_modules/@justinc/jsdocs/typedefs/index.jsdoc",
      "node_modules/@justinc/jsdocs/typedefs/Tuple.jsdoc"
    ]
  }

but I can’t do that as jsdoc errors out without --files.

[justin-calleja]

I was not using * I was using node_modules/@justinc/jsdocs/typedefs/{index,Tuple}.hbs which is workable for this use case but it doesn’t scale if there are other files to include from other modules.

I brought this issue up because I thought jsdoc2md can be made better if the user is not required to supply --files / --source when they’re using a jsdoc config file. CLI opts can be used to overwrite config in the file but why force me to have my config in 2 places.

In any case - it’s not a blocker, just a suggestion. … of course there are ways around it

[justin-calleja]

Ok, understood. I thought it was simply a matter of turning off required flags via some option in jsdoc2md’s config.

🍺