doc: describe input/output formats