2.1: slightly improve IO docs, see #2911