clarify inline docs for --format parameter; fixes #884