tomcat-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Rob S." <>
Subject RE: TC4 docs - can we end this?
Date Wed, 04 Jul 2001 11:20:11 GMT
It'll already take a tremendous amount of time to get the user's side up and
going, which is what I think the grand majority of people will benefit the
most from.  I'm not saying the dev design docs aren't extremely important,
I'm just saying that I want to spend my time where it will have the greated
effect =)

- r

> -----Original Message-----
> From: Antony Bowesman []
> Sent: Wednesday, July 04, 2001 2:19 AM
> To:
> Subject: Re: TC4 docs - can we end this?
> "Rob S." wrote:
> >
> > So please, can we at least START some discussion about the
> > contents of the docs other than "we need to write them" ?
> > There's a lot of work to be done, and I would imagine that
> > someone knows where a good place is to start.
> Let's start from the bottom up.  We already have the servlet API spec,
> so how about architectural design specs.  Filip Hanik, in his Tomcat
> Interceptors project, has some useful documentation and I have earlier
> provided feedback to him.
> However, I recently implemented a realm for TC 3.x and had some
> difficulties.  I had to understand TC source code to get a feel for the
> request processing architecture.  Some areas of Interceptors and
> Contexts are still unclear.  For example, what are notes?  These are
> referred to in ContextManager quite a lot and the SimpleRealm
> implementation but the purpose of them in a mystery.  Questions on the
> list didn't get replies.
> What issues need to be considered when extending things like
> BaseInterceptor with regard to the contexts, JVMs, class loaders and
> synchronisation requirements.
> I know it's a moving target all the time but architectural specs would
> help in getting more people involved in writing better code for the
> overall project.
> Antony

View raw message