src/io/*.h: add documentation to source and sink