Documentation improvements from review of DM-766

Adds documentation about examples scripts to doxygen
of CameraGeom.  Also clarified some of the assumptions
in the utils docstrings.