add comprehensive client reference, cleanup toctrees re #47