rust-gdb etc. wrapper documentation missing from --help, book, etc.

[ijackson]

Hi.

rustup (at leaast I assume it's rustup, since it seems like it's a hardlink to .cargo/bin/rustup) provided a wrapper rust-gdb on my PATH. This wrapper is convenient, so thanks.

However. I can't find any documentation about it. Some digging did find me the Rustup Book (although that is not installed by rustup!) which seems to have no mention of it. rustup man rust-gdb said no manual is available. rustup --help doesn't mention it. rust-gdb --help simply runs gdb and so prints gdb's help.

I suggest that:

• Whenever rustup is called as rust-gdb or cargo or something, and the first argument is --help, it ought to print a message saying "hello I am actually rustup acting as a wrapper for foo" and explaining where to get more information.

• There should be some documentation of these wrapper aliases somewhere. At the very leas there should be a list of them in the Rustup Book.

• Ideally there should be a way to find out what the extra arguments or environment are without using strace. This could be important, for example, if a user wants to do something that the rustup wrapper doesn't have direct support for.

[kinnison]

Taking your suggestions in order:

1. I think Quick addition to --version to mention rustc #2465 gives us precedent to possibly intercept --help on the proxies to mention rustup at least. As such I'd be pleased if a PR showed up to do that.
2. I agree that listing the proxies in the book makes sense. I've filed List proxies in the rustup book #2538 for this
3. You can do rustup run .... which might be all you need. If that's not going to do what you need, then we can look at another solution. (e.g. rustup run stable env)