usage note for YAML output (issue #1714)

See issue #1714