Hi Again, I had this discussion a couple of weeks ago and there was allot of interest in helping with the docs. The stumbling point as I see it is people just don't know how to submit changes to existing material or for that matter new material.
If you want to write whole chapters then; Basically, very basically, what you do is get the tools necessary to participate in a xml documentation project. Then you'll need the DTDs and style templates that are already being used for the current documentation. These are available via anonymous cvs. If you are making new pages or chapters then you'll need the above stuff to view it locally and see if it's correct. Then you'll have to post it to the Tomcat-dev list and someone there will review it and commit it, if it applies. If your just correcting or extending an existing page; All you need to do is download your target via cvs, do your corrections with any text editor and then diff it using cvs and post it to the Tomcat-dev mailing list. Someone there with commit privs will look at it and commit it, if it's deemed ok. Actually the dev list people are pretty good about accepting the changes when they get them, but there is a gap in showing everyone how to contribute, so they just don't get much to work with. So if you want to start your OWN documentation effort then the first thing you need to do is set up a cvs server. You will need to decide on what style your book should take, there are lots of examples out there. Then you set up a cvs root and start loading your docs. That way people who want to participate can download your xml style sheet, DTD's, xsl stuff and everyone would be on the same sheet of music. I would also recommend using cvsview so people could download stuff via http. You will also need some kind of mailing list so people who want to send in patches will have a place to send them, and committers will have a place to discuss things. Here's a pretty good description of what I'm trying to say, about xml. http://httpd.apache.org/docs-project/docsformat.html Here's a pretty good description of how the whole thing works. http://apache-server.com/tutorials/ATdocs-project.html Hope this helps, rls "yoom nguyen" <[EMAIL PROTECTED]> 10/17/2002 02:26 PM Please respond to "Tomcat Users List" To: "Tomcat Users List" <[EMAIL PROTECTED]> cc: Subject: John Turner or someone who resposible for Posting -- Re: How to Apache2, Tomcat4.1.2, JK2 ? Hi John You seems to be the one who would know where this question should go. Is there a link on apache's web site for people to share their detail (doc)work? People like Robert Sowders, and other? For the last two weeks I have seen many similar questions being asked over and over again by different people. If we can have a site that collecting this similar examples of different type of deployment. Then we are as a community of open sources be better off. You and everyone else will have more time to focus on the development instead of support it. A place to allow others to share their implementation experiences. There are too many combination of implementation from OS (Solaris, Windows, Linux..) to the application version (apache, tomcat, jboss, jk, ant, .....). I am volunter to host the site and have it link to apache/tomcat...site However, I will need some help to get it up and running properly for people to post their documentation and examples. I will need some help on coding the upload documentation module for different type of format (such as text, doc, html..). I will do the rest. I am not a coder. What would you guys say!!!! Thanks, Yoom --- Original Message ----- From: "Robert L Sowders" <[EMAIL PROTECTED]> Date: Thursday, October 17, 2002 4:03 pm Subject: Re: How to Apache2, Tomcat4.1.2, JK2 ? > Haven't tested with the latest, (I will later today), but this > should get > you going in the right direction. > > ftp://pokey.wr.usgs.gov/pub/rsowder > > Let me know. > > rls > > > > > > > "yoom nguyen" <[EMAIL PROTECTED]> > 10/17/2002 11:13 AM > Please respond to "Tomcat Users List" > > > To: [EMAIL PROTECTED] > cc: > Subject: How to Apache2, Tomcat4.1.2, JK2 ? > > Does any one get this combination of Apache2.0.43, Tomcat4.1.2 and > JK2.2.0.2 to work and documented? Would you share. > > > > My apaches 2.0.43 doesn't seems to communicate with tomcat 4.1.2. > I am > using jk2 (2.2.0.1)as the web connector. Apache2 in run on server > #1 > and Tomcat4.1.2 run on server #2. > > I am wondering if my setting are correct? Please let me > know if I miss something here. > > > Are these setting correct?? > > *** on server #1, start of workers2.properties file *** > # Shared memory handling. Needs to be set. > [shm] > file=/etc/httpd/logs/shm.file > size=1048576 > > # A List of tomcat workers > #worker.list=tomcat1 > > # Example socket channel, explicitly set port and host. > [channel.socket:209.104.159.91:8009] > port=8009 > host=209.104.159.91 > > # define the worker > [ajp13:209.104.159.91:8009] > channel=channel.socket:209.104.159.91:8009 > > # Uri mapping > [uri:/examples/*] > [uri:/*.jsp] > worker=ajp13:209.104.159.91:8009 > > # Announce a "status" worker > [status:status] > > [uri:/jkstatus/*] > worker=status:status > **** end of workers2.properties *** > > > > > *** on server, #1 start of httpd.conf file ******* > LoadModule jk2_module modules/mod_jk2.so > AddModule mod_jk2.c > JkWorkersFile /etc/httpd/conf/workers2.properties > JkLogFile /etc/httpd/logs/mod_jk.log > JkLogLevel info > JkLogStampFormat "[%a %b %d %H:%M:%S %Y] " > > #First Virtual Host access through port 80. > <VirtualHost 209.104.159.90:80> > ServerAdmin [EMAIL PROTECTED] > DocumentRoot /var/www/dev > ServerName www.test.com > ServerAlias gratiotonline.com > ErrorLog /var/www/dev/logs/error_log > </VirtualHost> > # > #First Virtual Host access through port 443. > <VirtualHost 209.104.259.90:443> > ServerAdmin [EMAIL PROTECTED] > DocumentRoot /var/www/dev > ServerName www.dev.com > SSLEngine On > ErrorLog /var/www/dev/logs/error_log > </VirtualHost> > ********** end of httpd.conf file ******* > > > **** on server #2, start of jk2.properties ***** > handler.list=apr,channelSocket,channelUnix,request > channelSocket.port=8009 > serverRoot=/etc/httpd > apr.jniModeSo=/etc/httpd/modules/mod_jk2.s > ************* end of jk2.properties ******** > > > thanks, Yoom > > > > -- > To unsubscribe, e-mail: <mailto:tomcat-user- > [EMAIL PROTECTED]>For additional commands, e-mail: > <mailto:tomcat-user-help@;jakarta.apache.org> > > > > > > -- > To unsubscribe, e-mail: <mailto:tomcat-user- > [EMAIL PROTECTED]>For additional commands, e-mail: > <mailto:tomcat-user-help@;jakarta.apache.org> > > -- To unsubscribe, e-mail: <mailto:tomcat-user-unsubscribe@;jakarta.apache.org> For additional commands, e-mail: <mailto:tomcat-user-help@;jakarta.apache.org> -- To unsubscribe, e-mail: <mailto:tomcat-user-unsubscribe@;jakarta.apache.org> For additional commands, e-mail: <mailto:tomcat-user-help@;jakarta.apache.org>
