src/io/source.h: improve documentation
src/io/sink.h: improve documentation, mentioning different sinks