updates for API documentation

These are updates to the documentation used by YARD.  Some classes/methods have been made private where they are confusing. Others have expanded documentation (to make them less confusing, as well).