ENH: added more flesh to doc