ccan/io: update and improve documentation.