Arbitrary flags for mdx

[MisterDA]

Desired Behavior

Although the mdx stanza in Dune covers a lot of possible interactions with ocaml-mdx, it doesn't cover all. It would be nice for easier debugging of mdx files to be able to add the verbose flag, for instance. There are also some customization options not covered by Dune: the syntax, various debugging flags, selecting subsections… The interaction between the current stanzas and specifying custom flags could be tricky. Maybe user-defined flags should overwrite stanzas? Or should we look in user flags to make sure there's no duplication? It would also make it easier to add new features to ocaml-mdx if the stanza doesn't catch up right away.

Example

The mdx stanza taken from current_examples:

(mdx
 (packages current_examples)
 (package current_examples)
 (files example_pipelines.md writing_plugins.md internals.md))

The same, with additional user-defined flags:

(mdx
 (packages current_examples)
 (package current_examples)
 (flags :standard --verbose --syntax=mli)
 (files example_pipelines.md writing_plugins.md internals.md))

[emillon]

See #2145 for a precedent with odoc. We decided not to support arbitrary flags, but rather to map these to dune features. I think that's what we should aim for too.

What kind of flags are you after?

• Passing --verbose depending on dune's verbosity level can be the right thing to do, assuming it's not visible from within what we execute (concretely, we don't want to make tests fail under dune runtest --verbose).

 (flags :standard --verbose --syntax=mli)
 (files example_pipelines.md writing_plugins.md internals.md))

• what does this mean? are those .md files actually ocaml interface files?