Suite state now documents and validates valid states.
Minor tidying up.
Correct output for 'requested state'.
Merge pull request #629 from arjclark/cylc-suite-state-docs-validate

cylc suite-state: validate inputs and improve documentation