fixes up doc comments