Documentation example should not use `opam run list`

[gasche]

The document uses consecutively

operf-micro list

and

operf-micro run list

I assumed that the latter was an ugly syntax to say "run all the benchmarks returned by the list command", not that they would build the benchmark for list-related functions.

You should clarify that ambiguity by choosing a different example of set of benchmarks in the second command.

[gasche]

P.S.: you should also document the command that run all built benchmarks.

[chambart]

The syntax of the documentation is clearly not the right one. This should be read as

operf-micro run [list]

For instance if you want to run bdd an kb benchmarks, you would run

operf-micro run bdd kb

[gasche]

I think it would be clearest to give operf-micro run as one example of command, and then operf-micro run bdd kb as another example. (Rather than giving the general rule in this introduction.)