[jboss-jira] [JBoss JIRA] Commented: (JBAS-5734) Installation And Getting Started Guide: Tomcat Documentation

Installation And Getting Started Guide: Tomcat Documentation ------------------------------------------------------------ Key: JBAS-5734 URL: https://jira.jboss.org/jira/browse/JBAS-5734 Project: JBoss Application Server Issue Type: Task Security Level: Public(Everyone can see) Components: Documentation Affects Versions: JBossAS-5.0.0.CR1 Environment: all Reporter: Erik Lindquist Assignee: Samson Kittoli The documentation available for Tomcat is incomplete and incorrect. Section 8.5 "The Web Container - Tomcat" states: "The embedded Tomcat service is the expanded deploy/jboss-web.deployer. All the necessary jar files needed by Tomcat can be found in there, as well as a web.xml (under the ROOT.war/WEB-INF) file which provides a default configuration set for web applications. " wrong. It is mixed up between two directories: default/deployers/jbossweb.deployer and default/deploy/jbossweb.sar. As far as I can tell, the former specifies what to deploy and the latter specifies how to do it.. web.xml can be found under the jbossweb.deployer directory and server.xml is found under jbossweb.sar This makes it really hard to define CATALINA_HOME. Also, the web.xml file still contains this comment: <!-- IMPORTANT: To use the SSI servlet, you also need to rename the --> <!-- $CATALINA_HOME/server/lib/servlets-ssi.renametojar file --> <!-- to $CATALINA_HOME/server/lib/servlets-ssi.jar --> You should just delete that. (goes for CGI too.) Best solution (IMHO) is to include a link to the appropriate Tomcat doc with along with any special JBoss specific usage notes.