Mailing-List: contact tomcat-dev-help@jakarta.apache.org; run by ezmlm
Message-ID: <39C033E3.8AE78324@eng.sun.com>
Date: Wed, 13 Sep 2000 19:11:47 -0700
From: "Pier P. Fumagalli" <pier.fumagalli@eng.sun.com>
Reply-To: pier.fumagalli@eng.sun.com
Organization: Sun Microsystems, Inc.
MIME-Version: 1.0
To: tomcat-dev@jakarta.apache.org
Subject: Re: ApJServ directives *must* have been documented by *now*... right?
References: <5E5BF8E44723D4119B6D00508BCC219AA412FF@mail1.hq.portera.com>
Content-Type: text/plain; charset=us-ascii
Content-Transfer-Encoding: 7bit

I feel guilty for that, being the first mod_jserv author... But I
remember that SOME YEARS AGO, I wrote a simple README with an
enumeration of all directives and what their meaning was... Because I
had trouble describing ApJServMount...
Tell me it's SOMEWHERE on the java.apache.org site, PLEEEEASE!!!

	Pier :)

Michael Percy wrote:
> 
> Joseph,
> Thanks for the input. I have seen these pages... there is nothing there
> specifically documenting the mod_jserv directives. There are a few examples,
> but they are scattered across the site and all are very basic stuff. What I
> would like to come up with is a comprehensive enumeration of configuration
> options and their statuses.
> 
> A couple of questions:
> Does anyone have developer's notes or anything of that nature?
> Who decides what directives go into the code?
> 
> Thanks,
> Mike
> 
> > -----Original Message-----
> > From: Joseph Chiu [mailto:jchiu@spun.com]
> > Sent: Monday, September 11, 2000 5:59 PM
> > To: tomcat-dev@jakarta.apache.org
> > Subject: RE: ApJServ directives *must* have been documented
> > by *now*...
> > right?
> >
> >
> > Hi Michael,
> > I'm not sure if you have seen the java.apache.org pages on
> > JServ.  There are
> > some useful links from there for mod_jserv configuration
> > (although they,
> > too, are not the most straight-forward).  The information is primarily
> > useful for server-side mod_jserv configuration; the
> > jserv.properties is not
> > a part of the TomCat mod_jserv implementation.;
> >
> > Joseph
> > -----Original Message-----
> > From: Michael Percy [mailto:mpercy@portera.com]
> > Sent: Monday, September 11, 2000 4:28 PM
> > To: 'general@jakarta.apache.org'; 'tomcat-dev@jakarta.apache.org'
> > Subject: ApJServ directives *must* have been documented by *now*...
> > right?
> >
> >
> > I have been looking everywhere, and can barely find a speck
> > of documentation
> > for the Apache directives added by mod_jserv (the ApJServ*
> > directives). The
> > single piece I could find is a README archived in the Apache JServ CVS
> > structure which was removed [Mon Nov 9 23:52:53 1998] which
> > documents them a
> > bit, but it is obsolete.
> > (see
> > http://www.working-dogs.com/cvsweb/index.cgi/jserv/src/c/Attic
> > /README?r1=1.1
> > 0)
> >
> > I have compiled the attached documentation for the mod_jserv
> > directives from
> > bits and pieces wherever I could find them (including the
> > source code), in
> > Apache-style HTML. The thing that gets me is that 90% of
> > people running
> > Tomcat are still using mod_jserv, with no documentation
> > whatsoever, probably
> > because that is what all the examples are written in (and
> > AFAIK mod_jk is
> > not fully developed yet).
> >
> > These are extremely draft docs, and I have no idea how
> > accurate it all is.
> > If anyone has a few moments to correct/enhance/help with
> > this, I would very
> > much appreciate it.