Patch Set 2: IP review completed

(15 inline comments)

Added some comments about pointing to other classes when deprecating something... also we should send an email to jgit-dev when we deprecate these and inform people that they will be removed by 1.0...