added some detail logging.
started making inroads towards writing the manual for v1.0