You are viewing a plain text version of this content. The canonical link for it is here.
Posted to users@tomcat.apache.org by Robert L Sowders <rs...@usgs.gov> on 2002/09/30 23:01:19 UTC
Documentation
Since most of the questions to tomcat-users list concern installation and
configuration issues it demonstrates that there is a real need for Tomcat
to have a "documentation project" that it's users can contribute to. Right
now most of the documentation consists of the xdocs which are pretty good,
but can be so much more. The developers obviously have little time to
maintain the present documentation and there is such an apparent need that
I wonder why a project for the documentation has not been started.
There are many "doc-projects" out there to emulate. I especially like the
one that the apache folks have running, the new xml documentation for
Apache 2.0 is probably the best I've seen.
I'm sure that many people would be willing to devote some time to
organizing and maintaining input from the community into a resource that
would benefit everyone. I for one would be willing to contribute, but
right now there is nothing an nowhere to submit to.
Should the developers of Tomcat initiate a project for the documentation?
Or should we? The Apache folks seem to have solved this issue, it remains
to be solved for Tomcat.
Have a look at some examples of opensouce projects which have solved their
documentation problems:
http://httpd.apache.org/docs-project/
http://www.freebsd.org/docproj/
http://www.debian.org/doc/ddp
http://developer.gnome.org/projects/gdp/
http://www.mulberrytech.com/dsssl/dsssldoc/index.html
http://pm-doc.sourceforge.net/
http://zdp.zope.org/
http://www.tldp.org/
rls
--
To unsubscribe, e-mail: <ma...@jakarta.apache.org>
For additional commands, e-mail: <ma...@jakarta.apache.org>
Re: Documentation
Posted by Glenn Nielsen <gl...@mail.more.net>.
Robert L Sowders wrote:
> Since most of the questions to tomcat-users list concern installation and
> configuration issues it demonstrates that there is a real need for Tomcat
> to have a "documentation project" that it's users can contribute to. Right
> now most of the documentation consists of the xdocs which are pretty good,
> but can be so much more. The developers obviously have little time to
> maintain the present documentation and there is such an apparent need that
> I wonder why a project for the documentation has not been started.
>
I would tend to agree with the above, those writing the code either don't
have the inclination or time to write up good documentation.
Have you looked at the latest docs for Tomcat 4.1? Much better jk documentation,
existing docs updated, and even some new documents at:
http://jakarta.apache.org/tomcat/tomcat-4.1-doc/index.html
Regards,
Glenn
--
To unsubscribe, e-mail: <ma...@jakarta.apache.org>
For additional commands, e-mail: <ma...@jakarta.apache.org>
Re: putting workers2.properties in $CATALINA_HOME/conf
Posted by Thad Humphries <th...@mindwrap.com>.
Never mind, I found it! In httpd.conf, put
# Tomcat mod_jk2.so Stuff
LoadModule jk2_module modules/mod_jk2.so
JkSet config.file /opt/jakarta/catalina/conf/workers2.properties
But tell me, why does workers2.properties use TOMCAT_HOME instead of
CATATLINA_HOME?
On Wed, 2002-10-02 at 12:51, Thad Humphries wrote:
> The docs
> (http://jakarta.apache.org/tomcat/tomcat-4.1-doc/jk2/jk2/configweb.html)
> says to put workers2.properties in
> "${serverRoot}/conf/workers2.properties, where ${serverRoot} is
> something like /opt/apache." And although the "Installation" section is
> blank (did someone say "documentation"?), I figured out to put
> LoadModule jk2_module modules/mod_jk2.so in my httpd.conf file.
>
> So, I've got Apache 2 and Tomcat 4.1 working with jk2. Great!
> Question: How can I put workers2.properties in $CATALINA_HOME/conf and
> get it read by Apache 2 (or 1.3) on startup? On most installs around
> here, the root user is responsible for everything under Apache and the
> web app administrator runs Tomcat so I'd like to put workers2.properties
> in the Tomcat tree.
> ...
--
------------------------------------------------------------------------
Thad Humphries "...no religious test shall ever be required
Web Development Manager as a qualification to any office or public
Phone: 540/675-3015, x225 trust under the United States." -Article VI
--
To unsubscribe, e-mail: <ma...@jakarta.apache.org>
For additional commands, e-mail: <ma...@jakarta.apache.org>
putting workers2.properties in $CATALINA_HOME/conf
Posted by Thad Humphries <th...@mindwrap.com>.
The docs
(http://jakarta.apache.org/tomcat/tomcat-4.1-doc/jk2/jk2/configweb.html)
says to put workers2.properties in
"${serverRoot}/conf/workers2.properties, where ${serverRoot} is
something like /opt/apache." And although the "Installation" section is
blank (did someone say "documentation"?), I figured out to put
LoadModule jk2_module modules/mod_jk2.so in my httpd.conf file.
So, I've got Apache 2 and Tomcat 4.1 working with jk2. Great!
Question: How can I put workers2.properties in $CATALINA_HOME/conf and
get it read by Apache 2 (or 1.3) on startup? On most installs around
here, the root user is responsible for everything under Apache and the
web app administrator runs Tomcat so I'd like to put workers2.properties
in the Tomcat tree.
--
------------------------------------------------------------------------
Thad Humphries "...no religious test shall ever be required
Web Development Manager as a qualification to any office or public
Phone: 540/675-3015, x225 trust under the United States." -Article VI
--
To unsubscribe, e-mail: <ma...@jakarta.apache.org>
For additional commands, e-mail: <ma...@jakarta.apache.org>
Re: Documentation
Posted by Thad Humphries <th...@mindwrap.com>.
I'll throw in what I can. Most of my TC "docs" consist of URLs and
hardcopy that I've collected here and there from the web, along with my
notes. Put me on your list...
If nothing else, it will help me to learn more aobut Tomcat...
On Mon, 2002-09-30 at 17:01, Robert L Sowders wrote:
> Since most of the questions to tomcat-users list concern installation and
> configuration issues it demonstrates that there is a real need for Tomcat
> to have a "documentation project" that it's users can contribute to. Right
> now most of the documentation consists of the xdocs which are pretty good,
> but can be so much more. The developers obviously have little time to
> maintain the present documentation and there is such an apparent need that
> I wonder why a project for the documentation has not been started.
>
> There are many "doc-projects" out there to emulate. I especially like the
> one that the apache folks have running, the new xml documentation for
> Apache 2.0 is probably the best I've seen.
>
> I'm sure that many people would be willing to devote some time to
> organizing and maintaining input from the community into a resource that
> would benefit everyone. I for one would be willing to contribute, but
> right now there is nothing an nowhere to submit to.
>
> Should the developers of Tomcat initiate a project for the documentation?
> Or should we? The Apache folks seem to have solved this issue, it remains
> to be solved for Tomcat.
>
> Have a look at some examples of opensouce projects which have solved their
> documentation problems:
>
> http://httpd.apache.org/docs-project/
> http://www.freebsd.org/docproj/
> http://www.debian.org/doc/ddp
> http://developer.gnome.org/projects/gdp/
> http://www.mulberrytech.com/dsssl/dsssldoc/index.html
> http://pm-doc.sourceforge.net/
> http://zdp.zope.org/
> http://www.tldp.org/
>
> rls
>
> --
> To unsubscribe, e-mail: <ma...@jakarta.apache.org>
> For additional commands, e-mail: <ma...@jakarta.apache.org>
>
>
--
------------------------------------------------------------------------
Thad Humphries "...no religious test shall ever be required
Web Development Manager as a qualification to any office or public
Phone: 540/675-3015, x225 trust under the United States." -Article VI
--
To unsubscribe, e-mail: <ma...@jakarta.apache.org>
For additional commands, e-mail: <ma...@jakarta.apache.org>