fix up documentation for fd vs IO objects