This function is generic; method functions can be written to handle
specific classes of objects. Classes which already have methods for
this function include all
an object from which a correlation matrix can be extracted.
some methods for this generic function require additional arguments.
will depend on the method function used; see the appropriate documentation.
José Pinheiro and Douglas Bates firstname.lastname@example.org
## see the method function documentation