Oops, forgot to mention.
Once you set everything up as xml then changing the docs to different
formats is pretty much a snap. Transformers for http, text, and pdf are
very common and available. You could conceivably make the docs available
in any format known. Or language for that matter, but that is another
topic.
rls
"Robert L Sowders" <[EMAIL PROTECTED]>
10/17/2002 07:24 PM
Please respond to "Tomcat Users List"
To: "Tomcat Users List" <[EMAIL PROTECTED]>
cc:
Subject: Re: John Turner or someone who responsible for Posting -- Re:
How to
Apache2, Tomcat4.1.2, JK2 ?
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>
--
To unsubscribe, e-mail: <mailto:tomcat-user-unsubscribe@;jakarta.apache.org>
For additional commands, e-mail: <mailto:tomcat-user-help@;jakarta.apache.org>
