Comment by rjwebb

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.