/docs/ will be not opened Reproducible: Always Steps to Reproduce: 1.compile tomcat with doc (add "www-servers/tomcat doc" to /etc/portage/package.use) 2. open http://localhost:8080/docs/ Actual Results: HTTP Status 404 - /docs/ type Status report message /docs/ description The requested resource (/docs/) is not available. Apache Tomcat/6.0.32 Expected Results: docs site will be open Look to "http://localhost:8080/manager/html" docs is a running application.
Do you have the examples use flag enabled? I think the docs webapp is some what dependent on that. However it should be available on its own, surely if the manager is showing it as a running web app. I must say I really don't care much about tomcat being able to serve up its own documentation that is readily available via the net or else where. My interest in maintaining Tomcat is for those who run it in a production server environment. Which there is no need to serve up local documentation. Changing the importance to minor as a result. Tons of tomcat bugs that need to be addressed before ones like this are addressed.
I have also enabled the examples use flag. But also no examples are available (but shown as running application). I'm a newbie with tomcat and this test was only made for a quick tour for my own. Next step should be make "icescrum" running with tomcat (at the moment showing as NOT running application). This can be discussed on another place (but where?). Please give me some hints to looking for (log files, error messages). I'm sure I will be find out the problematic point. Yes I have seen the bug list for tomcat during search for my problem and I understand your point of view. Please, can you tell me (possible via e-mail) which development environment do you use for tomcat?
I have solved the issue for the examples directory: /var/lib/tomcat-6/webapps/examples/WEB-INF/lib/jstl.jar was included as symbolic link to /usr/share/jakarta-jstl/lib/jstl.jar this caused an error: Failed to access resource /WEB-INF/lib/jstl.jar I have deleted the link and copied the jstl.jar in the directory, same with standard.jar. After restart the tomcat server the error is gone and the "examples" are accessible. But "docs" not working.
It seems the sites with an index.html are working f.e. "docs/appdev/sample/" or "docs/api" are shown. But the .xml files are not available.
The issue is that the docs/ directory that gets copied is the one with the XML files before the Ant scripts do their XSLT work on them, transforming them into .html files. Changing one line to copy the correct directory fixes the problem. --- tomcat-6.0.32-r1.ebuild 2011-07-29 23:47:45.899988500 -0500 +++ tomcat-6.0.32-r1-doc-fix.ebuild 2011-07-29 23:36:20.635894953 -0500 @@ -137,7 +137,7 @@ cp -pR host-manager "${D}"/usr/share/${TOMCAT_NAME}/webapps || die cp -pR manager "${D}"/usr/share/${TOMCAT_NAME}/webapps || die if use doc; then - cp -pR docs "${D}"/usr/share/${TOMCAT_NAME}/webapps || die + cp -pR "${S}"/output/build/webapps/docs "${D}"/usr/share/${TOMCAT_NAME}/webapps || die fi if use examples; then cd "${S}"/webapps/examples/WEB-INF/lib
Created attachment 281531 [details, diff] Fix for ebuild copying the wrong doc directory
fixed in 6.0.35 which will be stabilized soon because it also fixes CVE-2011-3190.
