Documentation update to omni_sample_dpdf

Update documentation in subroutines/omni_sample_dpdf.pro to explain that
this routine is not limited to use with DPDFs, but may be applied to any
pdf for which random samplings are desired.  Otherwise, some minor code
cleanup and potential bug fixes.