typos and dox fixes
(#305)
some possible dox errors and minor rearrangements in lensing engine
(#305)