Citing "Thank you for sharing. It IS useful information. Now if newbies would only search the archives before posting the same questions, we'd be all set! ;)"
Mmm, of course it would be great, but mailing lists are not in reality the place people look for documentation for world-class software products. They are not particularly usable, and much of it is conversation without solution, a lot of time can be wasted. The prevalence of Tomcat is obvious and synonymous in my view with J2EE web application development. But on the documentation front, BEA, IBM and the like out-do Tomcat easily. This will be a factor in Tomcat's ultimate success. Our .net boys have just completed their first ever project in J2EE/Tomcat/Struts/Hibernate and they had real problems and time loss scouting mailing lists and the web for documentation on configuration with IIS with respect to SSL and Virtual Hosting - 2 prevalent technologies used everywhere. Same goes for the other technologies (you know they are used to wizards lol) but there is some truth in it. I understand that with an open-source product this is never going to be the case and it relies on contributors to the project. For my part, I would like to help where I can with Tomcat's documentation and as you know I started that. I am going to think about the areas I think improvement can be made and make those suggestions. But you know, I submitted a logging page doc patch over a week ago and it's still not there, and since then there have been many posts asking about this problem. I don't find that encouraging. Also, there is very little documentation on how to even document! Tomcat developers make a lot of suggestions to people to "go write a document then" but never cite a definitive reference for how one would do that. There's a small page on how to build Tomcat but that's your lot (please correct me if I am wrong!). So that's a page I think could be helpful. Turns out you need an understanding of CVS, making a patch, the XDOC format. I had to scout all the Apache website to form a full view of how to do this. And how do you even preview your changes? Probably by having to grab Apache Forrest or something. Let's get a page detailing a step by step how to write and contribute documentation and then let's get Tomcat's docs up to scratch by really considering the areas that come up time and again in the lists and making the Tomcat documentation deserving of its functional reputation. Allistair. > -----Original Message----- > From: Shapira, Yoav [mailto:[EMAIL PROTECTED] > Sent: 24 November 2004 14:05 > To: Tomcat Users List > Subject: RE: SuSE 9.2 and Tomcat... > > > > Hi, > Thank you for sharing. It IS useful information. Now if > newbies would > only search the archives before posting the same questions, > we'd be all > set! ;) > > Yoav Shapira http://www.yoavshapira.com > > > >-----Original Message----- > >From: Quinton Delpeche [mailto:[EMAIL PROTECTED] > >Sent: Wednesday, November 24, 2004 2:28 AM > >To: [EMAIL PROTECTED] > >Subject: SuSE 9.2 and Tomcat... > > > >Hi Again, > > > >Well after pulling my hair out and getting very frustrated I have > finally > >fixed and documented everything that needs to be done in order to get > >Tomcat > >5 working on SuSE 9.2. > > > >This seems a little strange since I am using the version of > Tomcat that > >comes > >with SuSE 9.2, but I won't say anymore on the matter. > > > >There are basically two important permission things that need to be > done. > > > >1). The files admin.xml and manager.xml > >in /etc/tomcat5/base/Catalina/localhost/ need to be given > write access > to > >the > >tomcat user. > > > >There new profile should look like this: > >-rw-rw-r-- 1 root tomcat 862 Oct 5 03:20 admin.xml > >-rw-rw-r-- 1 root tomcat 428 Oct 5 03:20 manager.xml > > > >This fix removes the previous error regarding the admin and manager > >applications that I posted earlier. > > > >2). The tomcat user needs to be given access to /var/run in order to > create > >the relevant PID file. > > > >Because my server is behind a firewall and I change the ROOT and user > >password > >on the server regularly, I changed the /var/run permissions so that > >everyone > >could read and write from and to this directory. > > > >The new profile should look like this: > >drwxrwxrwx 15 root root 1032 Nov 24 09:11 run > > > >This fix solves various issues regarding the admin and manager > applications > >as > >well as the start.log error. > > > >Thats it. I don't know if this information will be useful to anyone, > but I > >thought I would share it with you all anyway. > > > >Regards > >Q > >-- > >Quinton Delpeche > >Internal Systems Developer > >Softline VIP > > > >Telephone: +27 12 420 7000 > >Direct: +27 12 420 7007 > >Facsimile: +27 12 420 7344 > > > >http://www.vippayroll.co.za/ > > > > A doctor, an architect, and a computer scientist were arguing > >about whose profession was the oldest. In the course of their > >arguments, they got all the way back to the Garden of Eden, whereupon > >the doctor said, "The medical profession is clearly the > oldest, because > >Eve was made from Adam's rib, as the story goes, and that > was a simply > >incredible surgical feat." > > The architect did not agree. He said, "But if you look at the > >Garden itself, in the beginning there was chaos and void, and out of > >that, the Garden and the world were created. So God must > have been an > >architect." > > The computer scientist, who had listened to all of this said, > >"Yes, but where do you think the chaos came from?" > > > > 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] > > <FONT SIZE=1 FACE="VERDANA,ARIAL" COLOR=BLUE> ------------------------------------------------------- QAS Ltd. Developers of QuickAddress Software <a href="http://www.qas.com";>www.qas.com</a> Registered in England: No 2582055 Registered in Australia: No 082 851 474 ------------------------------------------------------- </FONT> --------------------------------------------------------------------- To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
