DOC extend documentation on sample generators

Also allow make_multilabel_classification to return underlying
distributions.
Merge pull request #3001 from jnothman/doc_sample_gens

[MRG] improve documentation on sample generators