[Feature Request] Better documentation for Unix/Linux command line arguments?

[mdhall272]

The Unix/Linux command line help for rb is as follows:

$ rb-mpi --help
Usage: rb [OPTIONS]
       rb [OPTIONS] <file1> [<file2> ...]
Bayesian phylogenetic inference using probabilistic graphical models and an interpreted language

Options:
  -h [ --help ]         Show information on flags.
  -v [ --version ]      Show version and exit.
  -b [ --batch ]        Run in batch mode.
  -j [ --jupyter ]      Run in jupyter mode.
  --args arg            Command line arguments to initialize RevBayes
                        variables.
  --cmd arg             Script and command line arguments to initialize
                        RevBayes variables.
  --file arg            File(s) to source.
  --setOption arg       Set an option key=value.

See http://revbayes.github.io for more information.

As far as I can tell this is the limit of the documentation for these flags, anywhere. It took me quite some time to work out that --args simply fills a vector called args (which is not mentioned in https://revbayes.github.io/documentation/) and that if you do that then rb [OPTIONS] <file1> [<file2> ...] does not actually work (because everything after --args is used to fill args) and you need to specify --file instead. I do not need it right now, but I also have no idea how to approach using --cmd. It seems like these could use some elaboration.

Apologies if there is actually a tutorial for these somewhere, but I certainly could not find it.