Fix javadoc warnings

There was several incomplete javadoc comment blocks, fixed them up.

1. @return needs a param
2. The JD tool (or at least the 1.6 one) doesn't support {@link T} reference replacement
3. Had an extra unused @param from old code still in there