enhanced (hopefully) DBScan documentation; killed some whitespace along the way...
Merge remote-tracking branch 'upstream/master' into dbscan-doc-enh
Merge pull request #2076 from pprett/dbscan-doc-enh

MRG: Dbscan doc enh