a few fixes after review of the IO doc changes