random.h: add doxygen comments#1683

mvandenhoek wants to merge 2 commits intoeclipse-cyclonedds:mastereclipse-cyclonedds/cyclonedds:masterfrom

mvandenhoek:random_doc_branchmvandenhoek/cyclonedds:random_doc_branchCopy head branch name to clipboard