Potentially misleading rebar3 help plugins upgrade doc.

[paulo-ferraz-oliveira]

The output is

List or upgrade plugins
Usage: rebar3 plugins upgrade [<plugin>]

  <plugin>  Plugin to upgrade

which leads you to believe either a single (or all) plugin(s) can be upgraded (if we take [ and ] to mean "optional"), but that's not the case, since:

rebar3 plugins upgrade           
===> Must give an installed plugin to upgrade as an argument

I don't know which one is in the wrong, here, the code or the doc., but would really like to do rebar3 plugins upgrade and not care about a specific plugin 😄.

[paulo-ferraz-oliveira]

I was looking for an issue of this sort, today, and found mine :)

Quick question: is rebar3 plugins upgrade supposed to work for all plugins? Or is the doc. wrong?

[ferd]

I'd expect both to work, with or without a plugin. Without a plugin would upgrade all of them, and with one named, only that one (and its dependencies) would get upgraded.

[paulo-ferraz-oliveira]

"without a plugin" would be nice, since otherwise we need to go around this behaviour and list them or find them (via rebar3 commands). I'll try to eventually find some time to look at it.