https://bz.apache.org/bugzilla/show_bug.cgi?id=64290
--- Comment #9 from Markus Schlegel <sch...@gmail.com> --- I will change our code. Thank you guys for digging into this! I'll also check if we used some other inofficial classes. When I got you right, we should not use the tomcat classes at all but rather the apache-commons ones, correct? That's somewhat sad because behavior between tomcat built-in code and our addons might differ because of the different versions used. Also, I'm somewhat confused about what parts of tomcat-api are official or not. >From the release-notes I take, that only javax.** and org.apache.catalina.* (without subpackages) are considered stable. From the comments of you guys I take, that you assume that only these classes make up the official API (which is not necessary the case). But: 1. If "release-notes" is right, what about using classes from org.apache.juli as stated in https://tomcat.apache.org/tomcat-8.5-doc/logging.html ? Do people following your documentation have to use inoffical API's ? 2. Why do you provide an official javadocs page which provides Javadocs for internal, non-official packages which should not be used outside of tomcat ? Wouldn't it be clearer if you would provide API-Doc only for official API's? 3. Are javadoc-comments like "This package contains various IO related utility classes or methods, which are basically reusable and not necessarily restricted to the scope of a file upload." (from org.apache.tomcat.util.http.fileupload.util) wrong? Thanks for clearing this. -- You are receiving this mail because: You are the assignee for the bug. --------------------------------------------------------------------- To unsubscribe, e-mail: dev-unsubscr...@tomcat.apache.org For additional commands, e-mail: dev-h...@tomcat.apache.org
