src/io/source.h: improve documentation