Updated documentation. Changed parameters as ref to pointers

Updated the doxygen documentation on the PDF functions.

Also, changed the parameters passed as pointer to std::vector
instead of reference to std::vector.  Thus, if no parameters are
given for some functions we don't have to create any parameter vector.