documentation edits + more tests -- may have mem mgmt issue