Revise `@simd` documentation.

Three changes:
* Document that break, continue, and goto are not allowed (PR #8624).
* Mention that `&&`, `||`, and `?:` sometimes vectorize and use of `ifelse` instead of `?:`.
* Clean up `.rst` source to avoid excessively long lines and have consistent indentation.