Improve description for wait-for commands

[rsenden]

Although the default behavior of the wait-for commands is usually what users are looking for, these commands offer a lot of flexibility to support other/more advanced use cases. However, it may be difficult for users to get a clear understanding of the various options, in particular with regards to the --any-state, --until and --while options.

We should explain these options in more detail in the wait-for command descriptions, including examples, to allow users to get a better understanding of these options and how to use them.