some doc updates; R CMD check silencing