Allow using private fields in field by field comparison

Hello Joel :)

This a pull-request for issue #246. I included some minor cosmetic changes (javadoc fixes and missing Deprecated annotation) in separate commits. You can ignore them if you want to.