Made improvements to documentation and brought code closer to ISIS coding...

Made improvements to documentation and brought code closer to ISIS coding standards. Removed check for ellipsoid intersection in EquatorialCylindricalShape::intersectSurface() to prevent early return and attempt the iterative method even when the ellipsoid is not intersected. Fixes #1438

git-svn-id: http://subversion.wr.usgs.gov/repos/prog/isis3/trunk@6388 41f8697f-d340-4b68-9986-7bafba869bb8