Some cleanup of methods documentation
Updated vignette from knitr branch