fixed up the XML comments
made public method virtual so can override