fixup docs and zsh completion