correcting comments to compile with rst documentation