DOC: more (hopfully final) cleansing of docstrings
DOC: first draft of auto-generated reference manual for docs