update docs for new style comments