man: document --failed

https://bugs.debian.org/767267