rewrote the manual from scratch

code needs update — must add new exceptions as written in the manual.