Javadoc updates

git-svn-id: https://svn.apache.org/repos/asf/tomcat/trunk@1453842 13f79535-47bb-0310-9956-ffa450edef68
Align implementation with spec

git-svn-id: https://svn.apache.org/repos/asf/tomcat/trunk@1453843 13f79535-47bb-0310-9956-ffa450edef68
Remove unnecessary TODOs

git-svn-id: https://svn.apache.org/repos/asf/tomcat/trunk@1453845 13f79535-47bb-0310-9956-ffa450edef68
Address some low hanging TODOs

git-svn-id: https://svn.apache.org/repos/asf/tomcat/trunk@1453857 13f79535-47bb-0310-9956-ffa450edef68