Comments; totally done part 3

Added comments to the tricky parts of code, where issues could *appear*
to be (but aren't), and where methods have cryptic return types.