docs: improve documentation for subcommand

This commit adds docs for the wait subcommand and organizes the flags to
correctly reflect what can be set on the subcommand and what cannot be.

Fixes #2082