update documentation for S4 classes

proper documentation in Roxygen 4.0 style