If an IO error occurs while writing the doc comment stream we currently
let the exception rise out of the compiler. We should instead catch the
exception and surface a diagnostic.