Hi, I suppose some background information is in order. All of tomcat's documentation (and a vast majority of Apache documentation in general, so this will have wide applicability) is in XML format. Much of that for tomcat is visible at http://cvs.apache.org/viewcvs.cgi/jakarta-tomcat-catalina/webapps/docs/.
There are Ant and Maven tasks (you can use either one, we use Ant for tomcat as we're not mavenized) that will transform this XML docs to HTML using XSLT. Some transformers use Ant's style (aka xslt) task, some use Anakia (http://jakarta.apache.org/velocity/anakia.html), some use Maven's XDoc (http://maven.apache.org/reference/plugins/xdoc/). The XDoc plugin is probably the most full-featured one. The end result is at least one HTML file for each XML file. I say at least because some of these transformers generate menus and top pages. Yoav Shapira Millennium Research Informatics >-----Original Message----- >From: Rudolf Nottrott [mailto:[EMAIL PROTECTED] >Sent: Tuesday, March 23, 2004 12:31 PM >To: Tomcat Users List >Cc: Shapira, Yoav >Subject: RE: Tomcat documentation in "book format" (in contrast to the >myriad files in a Web documentation) > >I'm not really sure what this involves. It didn't occur to me that >documentation might be written as an Ant task. What would be the benefits >of that? Any examples of that kind of thing somebody else might have done >for other documentation? > >Rudolf > >At 09:40 AM 3/23/2004 -0500, you wrote: > >>Hi, >>You know, that would make for an EXCELLENT ant task or maven plugin. >>Feel like writing it? ;) >> >>Yoav Shapira >>Millennium Research Informatics >> >> >> >-----Original Message----- >> >From: Rudolf Nottrott [mailto:[EMAIL PROTECTED] >> >Sent: Monday, March 22, 2004 5:57 PM >> >To: Tomcat Users List >> >Subject: Tomcat documentation in "book format" (in contrast to the >>myriad >> >files in a Web documentation) >> > >> >Hi, >> > >> >I know the Tomcat documentation at >> >http://jakarta.apache.org/tomcat/tomcat-5.0-doc/index.html >> >it's excellent in content and complete, but I still vastly prefer the >>kind >> >of documentation that I can read like a book, rather than navigating a >> >myriad of file pieces linked together in Web fashion. >> > >> >My question is, does something like this exist for Tomcat? I mean the >> >documentation as a single file (PDF, html, or whatever), that I could >> >download and then read "beginning to end"? >> > >> >Thanks >> > >> >Rudolf >> > >>--------------------------------------------------------------------- >>To unsubscribe, e-mail: [EMAIL PROTECTED] >>For additional commands, e-mail: [EMAIL PROTECTED] > > >--------------------------------------------------------------------- >To unsubscribe, e-mail: [EMAIL PROTECTED] >For additional commands, e-mail: [EMAIL PROTECTED] This e-mail, including any attachments, is a confidential business communication, and may contain information that is confidential, proprietary and/or privileged. This e-mail is intended only for the individual(s) to whom it is addressed, and may not be saved, copied, printed, disclosed or used by anyone else. If you are not the(an) intended recipient, please immediately delete this e-mail from your computer system and notify the sender. Thank you. --------------------------------------------------------------------- To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
