Documentation updates

functions that override are not documented unless the behavior changes limits the functionality