put Eric's documentation changes into the roxygen documentation