CLI Reference -M option description is misleading

[seancorfield]

https://clojure.org/reference/deps_and_cli says of -M:

• If multiple -M alias maps are activated, only the last one will be used

And of -A:

• These aliases support ALL alias keys above and all will be applied

However, the clojure shell script assembles options in this order:

val="$(join '' ${resolve_aliases[@]})|$(join '' ${classpath_aliases[@]})|$(join '' ${all_aliases[@]})|$(join '' ${jvm_aliases[@]})|$(join '' ${main_aliases[@]})|$deps_data"

which means that if you specify an alias containing :main-opts via -A and another one via -M, the order of -M and -A does not follow the "last one will be used" principle because the :main-opts from -M will always override the :main-opts from -A.

I suggest adding a line to the description of -A that clarifies the order, something like:

• Aliases are applied as if provided in the order -R -C -A -O -M

[seancorfield]

@puredanger says this is a bug, not a documentation issue. https://dev.clojure.org/jira/browse/TDEPS-100 created to resolve this.