Sure, but it would be great if it went a little further: "... and/or provides a documentation panel for that argument". Having a one-liner to explain what ls's `--dired` does without having to drop down to a new line and look it up would be great, displaying the first sentence of the relevant section of the man page could be enough?
Doesn't zsh do something like this? At the very least, it seems to be extensible enough that you could provide completion+manpage documentation if you wanted to.
Zsh certainly does something like this.
Here's what my autocompletion looks like: http://leukensis.org/files/zsh-autocomplete.png
The program has to provide its autocomplete files, but it's very powerful. My 'kill' autocompletes with a ps-like output, for example.
Does zsh support matching long and arguments? That's what I want. A bit like fish (http://fishshell.com/assets/img/screenshots/man_completions....) and finalterm which others have mentioned.
It doesn't convert between long and short options or sort arguments but it does help you by offering the completion which means less typing and slightly less memorization.