cleanup of section 3 (theory) in lensing engine doc
(#248)