doc/comment updates