DO NOT REPLY TO THIS EMAIL, BUT PLEASE POST YOUR BUG RELATED COMMENTS THROUGH THE WEB INTERFACE AVAILABLE AT <http://issues.apache.org/bugzilla/show_bug.cgi?id=31191>. ANY REPLY MADE TO THIS MESSAGE WILL NOT BE COLLECTED AND INSERTED IN THE BUG DATABASE.
http://issues.apache.org/bugzilla/show_bug.cgi?id=31191 Better changelog/migration documentation Summary: Better changelog/migration documentation Product: Tomcat 5 Version: 5.5.1 Platform: All OS/Version: All Status: NEW Severity: Major Priority: Other Component: Catalina AssignedTo: [EMAIL PROTECTED] ReportedBy: [EMAIL PROTECTED] I'm going to take a risk and be a little undiplomatic for a second... You guys did a really poor job of documenting the changelog of Tomcat 5.5 You've made changes which break a lot of 3rd party software and discussed some (but not all) of them in the changelog with a level of brevity such that only someone who actually worked on the code would have any idea what the heck you were talking about. I am specifically refering to the following issues: - Moving "org.apache.commons.dbcp.BasicDataSourceFactory" to "org.apache.tomcat.dbcp.dbcp.BasicDataSourceFactory" - Moving java:comp/UserTransaction to java:comp/env/UserTransaction These things should be documented *in bold letters* in your changelog so that anyone running any sort of 3rd-party tool will be able to migrate without major havoc. Here is what little mention I found in your changelog: "Repackage commons-dbcp and its dependencies as a sigle smaller WAR, with renamed packages. (remm)" Yes... thank you... but give us enough details to make this comment useful please. Anyway, that's the end of my rant. The point isn't telling you guys off. The point is to provide constructive criticism as to what could and should be done better in future releases. Please incorporate these changes so other users don't have to waste as much time on it as I did. Thank you --------------------------------------------------------------------- To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
