Improve documentation of random() function.

Move random() and setseed() to a separate table, to have them grouped
together. Also add a notice that random() is not cryptographically secure.

Back-patch of commit 75fdcec1 into
all supported versions, per discussion of the need to document that
random() is just a wrapper around random(3).