update all doc comments to proper format