Re: First day - RE: PROPOSAL: Tomcat docs

[Antony Bowesman]

Punky Tse wrote:
> 
> Rob,
> Please see below for rephrased version of Introduction and 
> Administrator Guide.
> 
> I combined the Introduction and Administrator's Guide to Administrator
> Guide.  Actually this is my proposed TOC.  And I believe that we need
> separate document for different Tomcat servers.  e.g. 3.3 and 4.0.
> 


 
> II. Server Administration
> 
> 6. Configuring Server
> 
> 7. Configuring Web Applications
> 
> 8. Security

How about
8.1 Concepts - Explanation of J2EE and Java 2 security models
8.2 Authentication with Realms
8.2.1 Simple realm
8.2.2 JDBC Realm
8.2.3 Custom realms
8.3 Authorization
8.3.1 J2EE role based

In particular, it should try to explain in simpler terms than the API
spec how J2EE roles are designed to work, covering the mapping from
developer roles to deployment roles.

8.3.2 Java 2 security policy



> 
> III. Advanced Topics
> 
> 9. Web Servers and HTTP Connectors
> 9.1 Apache
> 9.1.1 mod_jk
> 9.1.2 mod_jserv
> 9.1.3 mod_webapp (for Tomcat 4.0)
> 9.2 IIS
> 9.3 iPlanet
> 9.4 Netware
> 9.5 Lotus Domino
> 
> 10. Performance Tuning
> 
> 11. Load-balancing
>  done through mod_jserv and mod_jk>
> 
> 12. Using SSL
> 
> 
> 13. Realms
> 

Don't think realms should be 'advanced'.  It should be convered in
security.  However, maybe there should be an advanced security section
covering

13. Security
13.1 Using Tomcat authentication with Webservers
13.1.1 Apache
13.1.2 IIS
13.1.3 iPlanet
13.1.4 Netware
13.1.5 Lotus Domino

Antony

Re: First day - RE: PROPOSAL: Tomcat docs

[Punky Tse]

Rob,
Please see below for rephrased version of Introduction and Administrator
Guide.
>
> 0) Introduction
>
>- Why use tomcat, what does it do and what doesn't it do?
>- Feature list as from tomcat 3 and as from tomcat 4 (group together
>  features and in which versions they appear/dissapear).
>- Requirements (JDK versions, extra libs?, etc.)
>- How-to submit a bug
>- How-to subscribe to tomcat-user/-dev & how-to UNSUBSCRIBE :)
>- Interesting links (api-spec, etc)
>
> 1) Administrator's Guide
>
>- Quick install (VERY short and simple)
>- Detailed installation?  Not a nice name...
>- Connectors and beyond.  Why choose which connector and
>  why don't use a certain connector?
>- Tomcat standalone
>- Apache
>- IIS
>- Netscape
>- Tomcat & SSL
>- Tips
>- (versioned?) Mini-FAQ
>- Advanced configuration
>- Complete server.xml reference
>- Heavy Load Guide (Loadbalancing)

I combined the Introduction and Administrator's Guide to Administrator
Guide.  Actually this is my proposed TOC.  And I believe that we need
separate document for different Tomcat servers.  e.g. 3.3 and 4.0.

I. Getting Started

1. Introduction
1.1 What is Tomcat
1.3 About Jakarta Project
1.2 About Apache

2. Installing Tomcat
2.1 Installation Guide
2.2 Supported Platfrom
2.3 Advanced Installation Guide
2.4 Troubleshooting

3. Tomcat Basics
3.1 Overview
3.2 Features
3.3 Directory Structures

4. Running Tomcat
4.1 Startup
4.2 Testing
4.3 Shutdown

5. Web Application
5.1 Installing
5.2 Testing
5.2 Trobleshooting
5.3 Advanced Topics

II. Server Administration

6. Configuring Server

7. Configuring Web Applications

8. Security

III. Advanced Topics

9. Web Servers and HTTP Connectors
9.1 Apache
9.1.1 mod_jk
9.1.2 mod_jserv
9.1.3 mod_webapp (for Tomcat 4.0)
9.2 IIS
9.3 iPlanet
9.4 Netware
9.5 Lotus Domino

10. Performance Tuning

11. Load-balancing


12. Using SSL


13. Realms


14. Building from Source
14.1 Getting Source Code
14.2 Compiling
14.3 CVS Repository

15. Get Involved
15.1 How to Contribute
15.2 Guidelines
15.3. Bug Reports
15.3.1 Bug Database
15.3.2 Submitting Bug Reports

IV. Appendices

A. server.xml reference
B. web.xml reference
C. Resources
C.1 Mailing Lists
C.2 Links
D. License
E. Acknowledgements & Credits


> 2) Web Application Developers' Guide
>
>- Things to know while developing with Tomcat.  The web dev
>  doesn't have to be an admin pro!
>
> 3) Container Architecture Guide
>
>- In this case also some references to technical docs which
>  explain how to start writing eg custom handlers, etc).

I think this two guides should be separated into two other documents.
Comparing the user base and developer base, I think almost all users
(administrators) will complain about documentation.  So Administrator Guide
is the 1st priority I believe.   But a introduction section for webapp
development should be in the Administrator Guide so that the webapp
developers are able to install their webapps to tomcat.  While the Webapp
developer guides documents some advanced topics.

Please advise if anybody get any idea.

Regards,
Punky

RE: Tomcat 3.2.2 and Error page 404

[Marc Saegesser]

This has already been fixed in 3.2.3-dev.  Try the latest nightly build.

> -Original Message-
> From: David Rees [mailto:[EMAIL PROTECTED]]
> Sent: Wednesday, July 04, 2001 3:14 PM
> To: [EMAIL PROTECTED]
> Subject: Re: Tomcat 3.2.2 and Error page 404
> 
> 
> On Wed, Jul 04, 2001 at 11:53:05AM -0700, Renato Weiner wrote:
> > 
> >  Hi all,
> > I know this has been discussed, but I can't find an ultimate 
> answer on this topic. I'm running Tomcat 3.2.2, I have latest the 
> StaticInterceptor.java from CVS. If I configure my web.xml with a 
> dynamic 404 error ( let's sat 404.jsp ) that doesn't exist, I got 
> an endless loop:
> > 
> > 2001-07-04 02:10:17 - Ctx( : ): 404 R(  + /servlet/xxx + 
> null) JSP file not found
> > 
> > 2001-07-04 02:10:17 - Ctx( : ): Get real path /404.jsp 
> /home/client1/404.jsp /home/client1
> > 
> > 2001-07-04 02:10:17 - Ctx( : ): Get real path /404.jsp 
> /home/client1/404.jsp /home/client1
> > 
> > 2001-07-04 02:10:17 - Ctx( : ): Get real path /404.jsp 
> /home/client1/404.jsp /home/client1
> > 
> > Do anybody has a solution for this ?
> 
> I have hit this myself.  The only solution is to make sure that 
> the error pages you 
> define in face do exist.  I haven't had time to look into root 
> cause of this myself, but 
> I'm not familiar with the Tomcat source anyway...
> 
> -Dave

Re: Tomcat 3.2.2 and Error page 404

[David Rees]

On Wed, Jul 04, 2001 at 11:53:05AM -0700, Renato Weiner wrote:
> 
>  Hi all,
> I know this has been discussed, but I can't find an ultimate answer on this topic. 
>I'm running Tomcat 3.2.2, I have latest the StaticInterceptor.java from CVS. If I 
>configure my web.xml with a dynamic 404 error ( let's sat 404.jsp ) that doesn't 
>exist, I got an endless loop:
> 
> 2001-07-04 02:10:17 - Ctx( : ): 404 R(  + /servlet/xxx + null) JSP file not found
> 
> 2001-07-04 02:10:17 - Ctx( : ): Get real path /404.jsp /home/client1/404.jsp 
>/home/client1
> 
> 2001-07-04 02:10:17 - Ctx( : ): Get real path /404.jsp /home/client1/404.jsp 
>/home/client1
> 
> 2001-07-04 02:10:17 - Ctx( : ): Get real path /404.jsp /home/client1/404.jsp 
>/home/client1
> 
> Do anybody has a solution for this ?

I have hit this myself.  The only solution is to make sure that the error pages you 
define in face do exist.  I haven't had time to look into root cause of this myself, 
but 
I'm not familiar with the Tomcat source anyway...

-Dave

Re: [jtc] apidocs

[Pier P. Fumagalli]

jean-frederic clere at [EMAIL PROTECTED] wrote:
> 
> The scandoc we use is 0.12 does it make sense to update it to 0.14 (The
> lastest one).

Yeah... I believe my patches were incorporated in the main tree, so, +1,
give a shot to 0.14...

Pier

Re: First day - RE: PROPOSAL: Tomcat docs

[Andy Armstrong]

"Rob S." wrote:
> 
> Shown below are the results of today's content and organizational
> suggestions.  It's still extreeemely rough, but this is the kind of stuff I
> like.  We're making progress! =)
> 
> - r
> 
> 0) Introduction
> 
>- Why use tomcat, what does it do and what doesn't it do?
>- Feature list as from tomcat 3 and as from tomcat 4 (group together
>  features and in which versions they appear/dissapear).
>- Requirements (JDK versions, extra libs?, etc.)
>- How-to submit a bug
>- How-to subscribe to tomcat-user/-dev & how-to UNSUBSCRIBE :)
>- Interesting links (api-spec, etc)

 - Comparisons with other containers

> 
> 1) Administrator's Guide
> 
>- Quick install (VERY short and simple)
>- Detailed installation?  Not a nice name...

 - In Depth Installation?

>- Connectors and beyond.  Why choose which connector and
>  why don't use a certain connector?
>- Tomcat standalone
>- Apache
>- IIS
>- Netscape

 - Domino ;-)

>- Tomcat & SSL
>- Tips

 - Style recommendations
 - Where to put JARs in different scenarios

>- (versioned?) Mini-FAQ
>- Advanced configuration
>- Complete server.xml reference
>- Heavy Load Guide (Loadbalancing)

 - Route map -- what lives where (server.xml/web.xml)

> 
> 2) Web Application Developers' Guide
> 
>- Things to know while developing with Tomcat.  The web dev
>  doesn't have to be an admin pro!

 - Links to other servlet/jsp resources

I'm guessing that we only want Tomcat specific stuff in here, so general
servlet topics might not be appropriate, but for the sake of
completeness a couple of worked examples of servlets and jsps might not
be out of place.

> 3) Container Architecture Guide
> 
>- In this case also some references to technical docs which
>  explain how to start writing eg custom handlers, etc).

-- 
Andy Armstrong, Tagish

First day - RE: PROPOSAL: Tomcat docs

[Rob S.]

Shown below are the results of today's content and organizational
suggestions.  It's still extreeemely rough, but this is the kind of stuff I
like.  We're making progress! =)

- r

0) Introduction

   - Why use tomcat, what does it do and what doesn't it do?
   - Feature list as from tomcat 3 and as from tomcat 4 (group together
 features and in which versions they appear/dissapear).
   - Requirements (JDK versions, extra libs?, etc.)
   - How-to submit a bug
   - How-to subscribe to tomcat-user/-dev & how-to UNSUBSCRIBE :)
   - Interesting links (api-spec, etc)

1) Administrator's Guide

   - Quick install (VERY short and simple)
   - Detailed installation?  Not a nice name...
   - Connectors and beyond.  Why choose which connector and
 why don't use a certain connector?
   - Tomcat standalone
   - Apache
   - IIS
   - Netscape
   - Tomcat & SSL
   - Tips
   - (versioned?) Mini-FAQ
   - Advanced configuration
   - Complete server.xml reference
   - Heavy Load Guide (Loadbalancing)

2) Web Application Developers' Guide

   - Things to know while developing with Tomcat.  The web dev
 doesn't have to be an admin pro!

3) Container Architecture Guide

   - In this case also some references to technical docs which
 explain how to start writing eg custom handlers, etc).

Tomcat 3.2.2 and Error page 404

[Renato Weiner]

 Hi all,
I know this has been discussed, but I can't find an ultimate answer on this topic. I'm running Tomcat 3.2.2, I have latest the StaticInterceptor.java from CVS. If I configure my web.xml with a dynamic 404 error ( let's sat 404.jsp ) that doesn't exist, I got an endless loop:
2001-07-04 02:10:17 - Ctx( : ): 404 R(  + /servlet/xxx + null) JSP file not found
2001-07-04 02:10:17 - Ctx( : ): Get real path /404.jsp /home/client1/404.jsp /home/client1
2001-07-04 02:10:17 - Ctx( : ): Get real path /404.jsp /home/client1/404.jsp /home/client1
2001-07-04 02:10:17 - Ctx( : ): Get real path /404.jsp /home/client1/404.jsp /home/client1
Do anybody has a solution for this ?
Thanks 
Renato.Do You Yahoo!?
Get personalized email addresses from Yahoo! Mail - only $35 
a year!http://personal.mail.yahoo.com/

What will happen to BUG #2333

[Roloff, Dirk]

Hi all,

just a question - i found an error in TC 3.2.2 and i hope i fixed it. I
added a Bugreport and a patch but no one here in the list say anything
about it, nore the report will be visited.
Nobody here with the same problem ? Who is the guy for AJP12 ?
Did i some thing wrong ? 


By the way - dose anybody know a way to send a JPEG-File to the Browser
so that _all_ browsers (MSE 5.0) will save it on disk (save as dialog)
and do not show it in a window ?
Setting MIME to youdonknoit/saveitondisk will not help M$ seams to look
inside the File an recognize it as JPEG doing default -> show it. 

Thanks an have nice day

Dirk

cvs commit: jakarta-tomcat-connectors/jk/native/common .cvsignore

[jfclere]

jfclere 01/07/04 10:09:36

  Added:   jk/native .cvsignore
   jk/native/common .cvsignore
  Log:
  Add the .cvsignore to make "cvs diff ." a little more readable.
  
  Revision  ChangesPath
  1.1  jakarta-tomcat-connectors/jk/native/.cvsignore
  
  Index: .cvsignore
  ===
  Makefile.in
  aclocal.m4
  configure
  config.log
  Makefile
  config.cache
  libtool
  config.status
  
  
  
  1.1  jakarta-tomcat-connectors/jk/native/common/.cvsignore
  
  Index: .cvsignore
  ===
  *.o
  *.lo
  *.slo
  .libs
  Makefile
  stamp-h.in
  list.mk
  stamp-h
  
  
  

cvs commit: jakarta-tomcat-connectors/jk/native/common jk_connect.c

[jfclere]

jfclere 01/07/04 09:59:39

  Modified:jk/native Makefile.am
   jk/native/common jk_connect.c
  Log:
  Add logic and first documentation for scandoc.
  
  Revision  ChangesPath
  1.2   +4 -0  jakarta-tomcat-connectors/jk/native/Makefile.am
  
  Index: Makefile.am
  ===
  RCS file: /home/cvs/jakarta-tomcat-connectors/jk/native/Makefile.am,v
  retrieving revision 1.1
  retrieving revision 1.2
  diff -u -r1.1 -r1.2
  --- Makefile.am   2001/06/05 10:27:47 1.1
  +++ Makefile.am   2001/07/04 16:59:36 1.2
  @@ -15,3 +15,7 @@
   (cd $$i && $(MAKE) $$target) || exit 1; \
fi; \
done;
  +
  +apidocs: common/*.h
  + ../../scandoc/scandoc.pl -i ../../scandoc/template.pl -p \
  + ./docs/api/ -dproject="mod_jk Library" common/*.h common/*.c
  
  
  
  1.3   +31 -6 jakarta-tomcat-connectors/jk/native/common/jk_connect.c
  
  Index: jk_connect.c
  ===
  RCS file: /home/cvs/jakarta-tomcat-connectors/jk/native/common/jk_connect.c,v
  retrieving revision 1.2
  retrieving revision 1.3
  diff -u -r1.2 -r1.3
  --- jk_connect.c  2001/06/18 14:15:34 1.2
  +++ jk_connect.c  2001/07/04 16:59:38 1.3
  @@ -55,17 +55,22 @@
*   *
* = */
   
  -/***
  - * Description: Socket/Naming manipulation functions   *
  - * Author:  Gal Shachor <[EMAIL PROTECTED]>   *
  - * Based on:Various Jserv files*
  - * Version: $Revision: 1.2 $   *
  - ***/
  +/*
  + * Description: Socket/Naming manipulation functions
  + * Based on:Various Jserv files
  + */
  +/**
  + * @package  jk_connect
  + * @author  Gal Shachor <[EMAIL PROTECTED]>
  + * @version $Revision: 1.3 $
  + */
   
   
   #include "jk_connect.h"
   #include "jk_util.h"
   
  +/** resolve the host IP */
  + 
   int jk_resolve(char *host,
  short port,
  struct sockaddr_in *rc) 
  @@ -100,6 +105,7 @@
   return JK_TRUE;
   }
   
  +/** connect to Tomcat */
   
   int jk_open_socket(struct sockaddr_in *addr, 
  int ndelay,
  @@ -154,6 +160,8 @@
   return -1;
   }
   
  +/** close the socket */
  +
   int jk_close_socket(int s)
   {
   #ifdef WIN32
  @@ -169,6 +177,16 @@
   return -1;
   }
   
  +/** send a long message
  + * @param sd  opened socket.
  + * @param b   buffer containing the data.
  + * @param len length to send.
  + * @return-2: send returned 0 ? what this that ?
  + *-3: send failed.
  + *>0: total size send.
  + * @bug   this fails on Unixes if len is too big for the underlying
  + * protocol.
  + */
   int jk_tcp_socket_sendfull(int sd, 
  const unsigned char *b,
  int len)
  @@ -193,6 +211,13 @@
   return sent;
   }
   
  +/** receive len bytes.
  + * @param sd  opened socket.
  + * @param b   buffer to store the data.
  + * @param len length to receive.
  + * @return-1: receive failed or connection closed.
  + *>0: length of the received data.
  + */
   int jk_tcp_socket_recvfull(int sd, 
  unsigned char *b, 
  int len) 
  
  
  

cvs commit: jakarta-tomcat-connectors/jk/native/docs/api README.txt

[jfclere]

jfclere 01/07/04 09:52:11

  Added:   jk/native/docs/api README.txt
  Log:
  Dummy file to get the docs/api directory created.
  
  Revision  ChangesPath
  1.1  jakarta-tomcat-connectors/jk/native/docs/api/README.txt
  
  Index: README.txt
  ===
  To generate the API documentation for the mod_jk library, simply invoke
make apidocs
  from the mod_jk Library root source path. (jakarta-tomcat-connectors/jk/native)
  
  
  

cvs commit: jakarta-tomcat-connectors/jk/native/docs/api - New directory

[jfclere]

jfclere 01/07/04 09:50:25

  jakarta-tomcat-connectors/jk/native/docs/api - New directory

cvs commit: jakarta-tomcat-connectors/jk/native/docs - New directory

[jfclere]

jfclere 01/07/04 09:50:06

  jakarta-tomcat-connectors/jk/native/docs - New directory

cvs commit: jakarta-tomcat-connectors/scandoc template.pl

[jfclere]

jfclere 01/07/04 09:45:14

  Modified:scandoc  template.pl
  Log:
  Fix the == to eq (PERL needs eq  for strings).
  
  Revision  ChangesPath
  1.5   +7 -7  jakarta-tomcat-connectors/scandoc/template.pl
  
  Index: template.pl
  ===
  RCS file: /home/cvs/jakarta-tomcat-connectors/scandoc/template.pl,v
  retrieving revision 1.4
  retrieving revision 1.5
  diff -u -r1.4 -r1.5
  --- template.pl   2001/04/24 20:19:58 1.4
  +++ template.pl   2001/07/04 16:45:13 1.5
  @@ -10,13 +10,13 @@
   ###
   ## Defaults for look and feel
   
  -if ($project == "") { $project = "WebApp Library"; }
  -if ($copyright == "") { $copyright = "2001, The Apache Software Foundation"; }
  -if ($body_bgcolor == "") { $body_bgcolor = '#ff'; }
  -if ($body_text== "") { $body_text= '#00'; }
  -if ($body_link== "") { $body_link= '#ff'; }
  -if ($body_vlink   == "") { $body_vlink   = '#ff'; }
  -if ($body_alink   == "") { $body_alink   = '#ff'; }
  +if ($project eq "") { $project = "WebApp Library"; }
  +if ($copyright eq "") { $copyright = "2001, The Apache Software Foundation"; }
  +if ($body_bgcolor eq "") { $body_bgcolor = '#ff'; }
  +if ($body_texteq "") { $body_text= '#00'; }
  +if ($body_linkeq "") { $body_link= '#ff'; }
  +if ($body_vlink   eq "") { $body_vlink   = '#ff'; }
  +if ($body_alink   eq "") { $body_alink   = '#ff'; }
   
   ###
   # Generate the frameset index #
  
  
  

RE: PROPOSAL: Tomcat docs

[Robert Slifka]

> How about "(Web?) Application Developers' Guide", to more 
> closely map to the
> servlet spec terminology. For the other bit, maybe "Container 
> Architecture Guide".
> I think we should avoid the phrase "Tomcat Developer" since, 
> as this mailing list 
> proves, many application developers think that since they are 
> developing on 
> Tomcat, they are Tomcat developers. 

Agreed on all counts.
 
> As a side-rant, "tomcat-dev" is really a bad name for this 
> list (and as a pattern 
> for the other Jakarta lists), since a "Windows Developer" 
> generally is someone 
> who develops for rather than implements the Windows platform, 
> ditto "Java 
> Developer", etc. "tomcat-contrib", "struts-contrib", etc. 
> would be much more
> intuitive.

I won't get into this ;)

- r

RE: PROPOSAL: Tomcat docs

[Kief Morris]

Robert Slifka typed the following on 09:45 AM 7/4/2001 -0400
>> 2) ""  Can't think of a title =) 
>> ^
>> Tomcat Webdeveloper Guide
>
>I think we do need to separate out the fact that there are a group of people
>who will developing/embedding/extending Tomcat, and a group of people that
>will be developing web applications for Tomcat.  As a web developer, I don't
>care a lot of about Tomcat's internals ;)

How about "(Web?) Application Developers' Guide", to more closely map to the
servlet spec terminology. For the other bit, maybe "Container Architecture Guide".
I think we should avoid the phrase "Tomcat Developer" since, as this mailing list 
proves, many application developers think that since they are developing on 
Tomcat, they are Tomcat developers. 

As a side-rant, "tomcat-dev" is really a bad name for this list (and as a pattern 
for the other Jakarta lists), since a "Windows Developer" generally is someone 
who develops for rather than implements the Windows platform, ditto "Java 
Developer", etc. "tomcat-contrib", "struts-contrib", etc. would be much more
intuitive.

K

Re: [jtc] apidocs

[jean-frederic clere]

"Pier P. Fumagalli" wrote:
> 
> jean-frederic clere at [EMAIL PROTECTED] wrote:
> 
> > Hi,
> >
> > I am starting to prepare mod_jk to use scandoc to generate the code
> > documentation.
> >
> > I have noted that mod_web uses include files as input but it seems more easy
> > to
> > use also the c sources files.
> >
> > Any comments?
> 
> The parsing in scandoc is pretty damn screwed... Try to see if it works, but
> I doubt that it will successfully parse all the sources. (On mod_webapp I
> use the headers since that's what they're doing in APR, and more
> specifically, because you don't actually care in which C file that function
> is defined, but more likely in which header, as you #include ).

Agreed but when someone writes/changes code there are more chances that comments
in the C sources file are created/updated than comments in a separe include. 

Scandoc parses without problems (well, without error messages) the
jakarta-tomcat-connectors/jk/native/common/*.h *.c.

But I have already one problem. @bug does not work... 

The scandoc we use is 0.12 does it make sense to update it to 0.14 (The lastest
one).

> 
> My 0.02 $
> 
> Pier

RE: PROPOSAL: Tomcat docs

[Martin van den Bemt]

Has someone got any ideas of how we are gonna gather all the information? I
have some things that come to mind, which can be forgotten tomorrow ;-).
Maby by using the faq that was around in the jserv erra ;) and add entries
there? Or is someone already gonna be a mail repository for this?
Maby I can setup a mailinglist on my server for this, until we get things
really running. Still fighting with the mailinglist a bit, but if the idea
is welcomed, I'll make it a "spare time" top priority.

Mvgr,
Martin van den Bemt


> -Original Message-
> From: Thomas Bezdicek [mailto:[EMAIL PROTECTED]]
> Sent: Wednesday, July 04, 2001 4:11 PM
> To: [EMAIL PROTECTED]
> Subject: AW: PROPOSAL: Tomcat docs
>
>
> > More refinements...  if i didn't quote it, I agree with it =)  BTW, what
> > does "AW" in a subject line mean?  I see it all the time...
> AW = Antwort which is pretty the same like RE=reply in english,
> except that
> it is in german :) Its done by outlock.
>
> > 0) Introduction to the TC4 container
> > ADD > - Requirements (JDK versions, extra libs?, etc.)
> agree
>
> > 1) "User's Guide" (or "Administrator's")
> > > - Tomcat and different JDK Versions
> > Moved this up to (0)
> agree
>
> > > 2) ""  Can't think of a title =)
> > > ^
> > > Tomcat Webdeveloper Guide
> >
> > I think we do need to separate out the fact that there are a
> > group of people
> > who will developing/embedding/extending Tomcat, and a group of
> people that
> > will be developing web applications for Tomcat.  As a web
> > developer, I don't care a lot of about Tomcat's internals ;)
> Ok, but I think it is better to split the pure administrator stuff
> from what ever kind of developer stuff.
> developers who want to extend/embedd tomcat will be much more interessted
> in the api-docs and specs. normal webdevelopers arent interessted in that.
>
> 2) Tomcat Development Guide
>- Web developers
>- extending/embedding Tomcat
>
> > 3) "Tomcat Upgrade Guide"
> >
> > I think this would equate to a lot of feature mapping from one
> > container to
> > another.  The Admin's guide should suffice.  REALLY all you
> need to do is
> > drop a .WAR file in and change the port to get the container running
> > standalone.
> ask someone who ported from jserv to tomcat :)) just the zone handling
> (which was a real crap in jserv) ... and for those upgrading from servlet
> api 2.2 to 2.3 there might also be some tiny changes which might result
> in a major problem ...
> and even the what is a ".war" file would be much help for beginners.
>
> > > 4) "Appendix"
> >
> > Suggest that we move this all up into (0).  I'd like people to
> know these
> > things asap =)  With the history of doc reading, I dunno anyone
> would make
> > it this far!
> hmm, I do. (like me)
>
>
> tom
>
>

AW: PROPOSAL: Tomcat docs

[Thomas Bezdicek]

> More refinements...  if i didn't quote it, I agree with it =)  BTW, what
> does "AW" in a subject line mean?  I see it all the time...
AW = Antwort which is pretty the same like RE=reply in english, except that
it is in german :) Its done by outlock.

> 0) Introduction to the TC4 container
> ADD > - Requirements (JDK versions, extra libs?, etc.)
agree

> 1) "User's Guide" (or "Administrator's")
> > - Tomcat and different JDK Versions
> Moved this up to (0)
agree

> > 2) ""  Can't think of a title =)
> > ^
> > Tomcat Webdeveloper Guide
>
> I think we do need to separate out the fact that there are a
> group of people
> who will developing/embedding/extending Tomcat, and a group of people that
> will be developing web applications for Tomcat.  As a web
> developer, I don't care a lot of about Tomcat's internals ;)
Ok, but I think it is better to split the pure administrator stuff
from what ever kind of developer stuff.
developers who want to extend/embedd tomcat will be much more interessted
in the api-docs and specs. normal webdevelopers arent interessted in that.

2) Tomcat Development Guide
   - Web developers
   - extending/embedding Tomcat

> 3) "Tomcat Upgrade Guide"
>
> I think this would equate to a lot of feature mapping from one
> container to
> another.  The Admin's guide should suffice.  REALLY all you need to do is
> drop a .WAR file in and change the port to get the container running
> standalone.
ask someone who ported from jserv to tomcat :)) just the zone handling
(which was a real crap in jserv) ... and for those upgrading from servlet
api 2.2 to 2.3 there might also be some tiny changes which might result
in a major problem ...
and even the what is a ".war" file would be much help for beginners.

> > 4) "Appendix"
>
> Suggest that we move this all up into (0).  I'd like people to know these
> things asap =)  With the history of doc reading, I dunno anyone would make
> it this far!
hmm, I do. (like me)


tom

RE: PROPOSAL: Tomcat docs

[Martin van den Bemt]

AW = Antwort (this is German for RE:) or Antwoord (dutch for RE:)..
Agreed with your comments. Especially the unsubcribe part should me the
first sentence in the docs ;)

Especially digging into the extra libs will be very usefull. Need some
extensive docs on that. Especially tomcat 4 is confusing (although a lot
better now) with the huge number of libs it needs (or likes to have). Not
all libs are needed to build everything as far as I know, so it should also
state what functionality you're gonna miss (and maby some "real life"
examples of what that functionality can do for you). An example :

If you want to build in support for JNDI JDBC Datasource you to download
 (snapped from the tomcat 4 README.txt). It is nice to know what you are
missing if you don't include this. Most admins don't have a clue what to do
with this and a lot of developers too. When you get a real life example
(just text, not necessarily code and a little more detailed then : you can
have JDBC datasources using JNDI when you use this). We don't want to be a
dictionary ;-))
A lot of people are confronted with stuff they would never have seen, so
some extra info could be usefull (I think I made my point).

Mvgr,
Martin

> -Original Message-
> From: Robert Slifka [mailto:[EMAIL PROTECTED]]
> Sent: Wednesday, July 04, 2001 3:46 PM
> To: '[EMAIL PROTECTED]'
> Subject: RE: PROPOSAL: Tomcat docs
>
>
> More refinements...  if i didn't quote it, I agree with it =)  BTW, what
> does "AW" in a subject line mean?  I see it all the time...
>
> 0) Introduction to the TC4 container
> ADD > - Requirements (JDK versions, extra libs?, etc.)
>
> 1) "User's Guide" (or "Administrator's")
> > - Tomcat and different JDK Versions
> Moved this up to (0)
>
> > 2) ""  Can't think of a title =)
> > ^
> > Tomcat Webdeveloper Guide
>
> I think we do need to separate out the fact that there are a
> group of people
> who will developing/embedding/extending Tomcat, and a group of people that
> will be developing web applications for Tomcat.  As a web
> developer, I don't
> care a lot of about Tomcat's internals ;)
>
> 3) "Tomcat Upgrade Guide"
>
> I think this would equate to a lot of feature mapping from one
> container to
> another.  The Admin's guide should suffice.  REALLY all you need to do is
> drop a .WAR file in and change the port to get the container running
> standalone.
>
> > 4) "Appendix"
>
> Suggest that we move this all up into (0).  I'd like people to know these
> things asap =)  With the history of doc reading, I dunno anyone would make
> it this far!
>
> - r
>

Re: [jtc] apidocs

[Pier P. Fumagalli]

jean-frederic clere at [EMAIL PROTECTED] wrote:

> Hi,
> 
> I am starting to prepare mod_jk to use scandoc to generate the code
> documentation.
> 
> I have noted that mod_web uses include files as input but it seems more easy
> to
> use also the c sources files.
> 
> Any comments?

The parsing in scandoc is pretty damn screwed... Try to see if it works, but
I doubt that it will successfully parse all the sources. (On mod_webapp I
use the headers since that's what they're doing in APR, and more
specifically, because you don't actually care in which C file that function
is defined, but more likely in which header, as you #include ).

My 0.02 $

Pier

RE: PROPOSAL: Tomcat docs

[Robert Slifka]

More refinements...  if i didn't quote it, I agree with it =)  BTW, what
does "AW" in a subject line mean?  I see it all the time...

0) Introduction to the TC4 container
ADD > - Requirements (JDK versions, extra libs?, etc.)
 
1) "User's Guide" (or "Administrator's") 
> - Tomcat and different JDK Versions
Moved this up to (0)
 
> 2) ""  Can't think of a title =) 
> ^
> Tomcat Webdeveloper Guide

I think we do need to separate out the fact that there are a group of people
who will developing/embedding/extending Tomcat, and a group of people that
will be developing web applications for Tomcat.  As a web developer, I don't
care a lot of about Tomcat's internals ;)

3) "Tomcat Upgrade Guide"

I think this would equate to a lot of feature mapping from one container to
another.  The Admin's guide should suffice.  REALLY all you need to do is
drop a .WAR file in and change the port to get the container running
standalone.
 
> 4) "Appendix"

Suggest that we move this all up into (0).  I'd like people to know these
things asap =)  With the history of doc reading, I dunno anyone would make
it this far!

- r

[jtc] apidocs

[jean-frederic clere]

Hi,

I am starting to prepare mod_jk to use scandoc to generate the code
documentation.

I have noted that mod_web uses include files as input but it seems more easy to
use also the c sources files.

Any comments?

Cheers

Jean-frederic

AW: PROPOSAL: Tomcat docs

[Thomas Bezdicek]

Just another (enhanced) grouping ...

0) Introduction to the TC4 container

   > - Why use tomcat, what does it do and what doesn't it do?
   > - Feature list as from tomcat 3 and as from tomcat 4 (group together
   >   features and in which versions they appear/dissapear).

1) "User's Guide" (or "Administrator's") 
^
This definetly Administrator stuff (Tomcat Administrator Guide)

   > - Plain Installation and upgrades of the various tomcat 
   >   versions (and maby jserv upgrade to tomcat)
   > - Connectors and beyond ;-)) Why choose which connector and 
   >   why don't use a certain connector?
   >   - Tomcat standalone
   >   - Apache
   >   - IIS
   >   - Netscape
   > - Tomcat & SSL
   > - a tips reference
   > - a faq reference (would be nice if there is a reference to 
   >   the version it's about or from what version the Question is valid.
   > - Advanced configuration (what are all the entries for).
   >   - Heavy Load Guide (Loadbalancing)
   > - Tomcat and different JDK Versions

2) ""  Can't think of a title =) 
^
Tomcat Webdeveloper Guide

   > - Things to know while developing with Tomcat.  The web dev
   >   doesn't have to be an admin pro!
   > - In this case also some references to technical docs which
   >   explain how to start writing eg custom handlers, etc).
   > - a tomcat programmers manual

3) "Tomcat Upgrade Guide"
   > - Upgrading from jserv -> tomcat 3/4
   > - Upgrading from tomcat 3 -> tomcat 4
   > - "Upgrading" from XY servletcontainer -> tomcat 3/4

4) "Appendix"
   > - Interessting links (api-spec, etc)
   > - API-javadoc
   > - How-to submit a bug
   > - How-to subscribe to tomcat-user/-dev & how-to UNSUBSCRIBE :)

tom

RE: PROPOSAL: Tomcat docs

[Robert Slifka]

...and thank you btw =)  I'm getting more excited now since this is exactly
the type of discussion I hoped we would be in!  (re: suggesting different
sections, etc.)

I'll just throw this out there and everyone can quote it, etc.  It contains
a few of mine, and all of Martin's (spliced, relocated, etc.).

- r

0) Introduction to the TC4 container

   > - Why use tomcat, what does it do and what doesn't it do?
   > - Feature list as from tomcat 3 and as from tomcat 4 (group together
   >   features and in which versions they appear/dissapear).

1) "User's Guide" (or "Administrator's")

   > - Plain Installation and upgrades of the various tomcat 
   > versions (and maby jserv upgrade to tomcat)
   > - Connectors and beyond ;-)) Why choose which connector and 
   > why don't use a certain connector?
   > - a tips reference
   > - a faq reference (would be nice if there is a reference to 
   >   the version it's about or from what version the Question is valid.
   > - Advanced configuration (what are all the entries for).

2) ""  Can't think of a title =)

   > - Things to know while developing with Tomcat.  The web dev
   >   doesn't have to be an admin pro!

3) "Tomcat Developer's Guide"

   > - In this case also some references to technical docs which
   >   explain how to start writing eg custom handlers, etc).
   > - a tomcat programmers manual

- r

RE: PROPOSAL: Tomcat docs - was TC4 docs - can we end this?

[Martin van den Bemt]

First get things going, after that worry about format etc.. Else we never
have the documentation we really want / need. That's why the big +1 on your
e-mail ;)

Mvgr,
Martin van den Bemt

> -Original Message-
> From: Robert Slifka [mailto:[EMAIL PROTECTED]]
> Sent: Wednesday, July 04, 2001 2:47 PM
> To: '[EMAIL PROTECTED]'
> Subject: RE: PROPOSAL: Tomcat docs - was TC4 docs - can we end this?
>
>
> For the record, I'm going to keep track of the different proposals in a
> separate doc.  For the TC docs - what to include, the glue, etc.
>
> I'm no longer participating in the "how do we store it or what
> format do we
> use" discussion =)
>
> - r
>
> > -Original Message-
> > From: Martin van den Bemt [mailto:[EMAIL PROTECTED]]
> > Sent: July 4, 2001 8:32 AM
> > To: [EMAIL PROTECTED]
> > Subject: PROPOSAL: Tomcat docs - was TC4 docs - can we end this?
> >
> >
> > A very big +1, See feedback below..
> >
> > > 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.
> >
> > There are x main parts for the documentation :
> >
> > - Why use tomcat, what does it do and what doesn't it do?
> > - Plain Installation and upgrades of the various tomcat
> > versions (and maby
> > jserv upgrade to tomcat)
> > - Connectors and beyond ;-)) Why choose which connector and
> > why don't use a
> > certain connector?
> > - Advanced configuration (what are all the entries for). In
> > this case also
> > some references to technical docs which explain how to start
> > writing eg
> > custom handlers, etc).
> > - Feature list as from tomcat 3 and as from tomcat 4 (group together
> > features and in which versions they appear/dissapear).
> > - a tomcat programmers manual
> > - a tips reference
> > - a faq reference (would be nice if there is a reference to
> > the version it's
> > about or from what version the Question is valid.
> > - An administrator guide for tomcat.
> >
> >
> > Mvgr,
> > Martin van den Bemt
> >
> >
>

RE: PROPOSAL: Tomcat docs - was TC4 docs - can we end this?

[Robert Slifka]

For the record, I'm going to keep track of the different proposals in a
separate doc.  For the TC docs - what to include, the glue, etc.

I'm no longer participating in the "how do we store it or what format do we
use" discussion =)

- r

> -Original Message-
> From: Martin van den Bemt [mailto:[EMAIL PROTECTED]]
> Sent: July 4, 2001 8:32 AM
> To: [EMAIL PROTECTED]
> Subject: PROPOSAL: Tomcat docs - was TC4 docs - can we end this?
> 
> 
> A very big +1, See feedback below..
> 
> > 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.
> 
> There are x main parts for the documentation :
> 
> - Why use tomcat, what does it do and what doesn't it do?
> - Plain Installation and upgrades of the various tomcat 
> versions (and maby
> jserv upgrade to tomcat)
> - Connectors and beyond ;-)) Why choose which connector and 
> why don't use a
> certain connector?
> - Advanced configuration (what are all the entries for). In 
> this case also
> some references to technical docs which explain how to start 
> writing eg
> custom handlers, etc).
> - Feature list as from tomcat 3 and as from tomcat 4 (group together
> features and in which versions they appear/dissapear).
> - a tomcat programmers manual
> - a tips reference
> - a faq reference (would be nice if there is a reference to 
> the version it's
> about or from what version the Question is valid.
> - An administrator guide for tomcat.
> 
> 
> Mvgr,
> Martin van den Bemt
> 
> 

Re: Still being flooded with EMAILS!!!!!!!!!!!!!!!!!!!!!!

[Thomas Colin de Verdiere]

did you reply to confirmation
You must reply to unsubscribe

"Rob S." wrote:
> 
> I'm not quite sure that the list owner (that person's email is in the
> subscription notice) reads this list.  I've always gotten a response (and
> action) from the list owner, it just takes a few days.
> 
> Can't you setup a filter in Outlook, Eudora, Pine, whatever, to /null all
> "tomcat-dev" messages?  At least until the list owner replies?
> 
> - r
> 
> > -Original Message-
> > From: [EMAIL PROTECTED] [mailto:[EMAIL PROTECTED]]On Behalf Of
> > Sebastian Mangels
> > Sent: Wednesday, July 04, 2001 6:03 AM
> > To: [EMAIL PROTECTED]
> > Subject: Still being flooded with EMAILS!!
> >
> >
> > I'm still being flooded with your emails.
> >
> > just again:
> >
> > PLEASE GET ME OFF YOUR MAILING LIST.
> >
> > I DID unsubscribe SEVERAL times. Your mailing system
> > did confirm that (I have evidence...) . The owner of your
> > mailing list doesn't seem to react. I'm sorry to post again
> > in your forum, but I don't see any other chance.
> >
> > Thanks,
> > Sebastian.
> >
> > Sebastian Mangels schrieb:
> >
> > > Hi!
> > >
> > > I did unsubscribe several times (was confirmed by the mailing
> > system...).
> > > I wrote to the owner of the mailing list to get me off his list...
> > > I'm still being flooded with emails.
> > >
> > > PLEASE, get me off this list.
> > >
> > > Thanks,
> > > Sebastian.
> > >
> > > --
> > > -
> > >  Sebastian Mangels
> > >  freiheit.com Technologieberatung GmbH
> > >  Westend Village, Haus 6a, Loft 636
> > >  Theodorstrasse 42-90  Tel.: +49 40 890 584 - 0
> > >  22761 Hamburg Fax.: +49 40 890 584 - 20
> > > -
> >
> > --
> > -
> >  Sebastian Mangels
> >  freiheit.com Technologieberatung GmbH
> >  Westend Village, Haus 6a, Loft 636
> >  Theodorstrasse 42-90  Tel.: +49 40 890 584 - 0
> >  22761 Hamburg Fax.: +49 40 890 584 - 20
> > -
> >
> >
> >
> >

PROPOSAL: Tomcat docs - was TC4 docs - can we end this?

[Martin van den Bemt]

A very big +1, See feedback below..

> 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.

There are x main parts for the documentation :

- Why use tomcat, what does it do and what doesn't it do?
- Plain Installation and upgrades of the various tomcat versions (and maby
jserv upgrade to tomcat)
- Connectors and beyond ;-)) Why choose which connector and why don't use a
certain connector?
- Advanced configuration (what are all the entries for). In this case also
some references to technical docs which explain how to start writing eg
custom handlers, etc).
- Feature list as from tomcat 3 and as from tomcat 4 (group together
features and in which versions they appear/dissapear).
- a tomcat programmers manual
- a tips reference
- a faq reference (would be nice if there is a reference to the version it's
about or from what version the Question is valid.
- An administrator guide for tomcat.


Mvgr,
Martin van den Bemt

RE: Tomcat Documentation Project

[Martin van den Bemt]

Hi Pier,

> >
> > 1. Tomcat documentation sucks :-)
>
> +1
>
> > 2. There needs to be a new CVS project called jakarta-tomcat-doc.
>
> Strong -1. Tomcat 3.x and 4.x have just one thing in common right now. The
> friggin' servlet spec (and not even that since between the two
> versions they
> implement there is _quite_ a difference).
>
> All the rest is different, from how you build them, to how you configure
> them, to the "technical" aspects of it...
>
> And being so different, I strongly believe that the documentation
> should be
> on two different separate CVS trees, as the two "versions" are on two
> separate CVS trees...

Maby there is a big difference between the versions of tomcat (installation
etc), but from my point of view the ideal world (which we all want) is the
documentation combined together. (I'm talking my situation here and didn't
do a survey or something). I use almost all the tomcat versions available
and when necessary I have to drag the documentation from everywhere to see
what a certain version was all about to install etc. I don't think I'm the
only one who uses jserv, tomcat 3.1, tomcat 3.2, tomcat 3.2.1 tomcat 3.2.2,
tomcat 3.3 and tomcat 4.0 (ehh the last one isn't used very much yet..). All
servers have different versions and also for different reasons. To keep
track of all the versions is hard enough as it is, so regurarly updating the
docs for all tomcat versions from the cvs tree is an ideal scenario for me.
Having more and more cvs trees is also getting a little bit confusing.. Also
a lot of people are upgrading from a version to a version, so you want to be
able to compare settings with other versions easily, without checking out a
certain branch etc,etc.
So my vote (if it counts), is one big (organized!) bucket of docs..
Hope my input is any usefull.

Mvgr,
Martin van den Bemt

cvs commit: jakarta-tomcat-connectors/webapp/scandoc scandoc.pl template.pl

[jfclere]

jfclere 01/07/04 05:04:07

  Removed: webapp/scandoc scandoc.pl template.pl
  Log:
  Move scandoc to jakarta-tomcat-connectors to share it with mod_jk.

Re: TC4 docs - can we end this?

[Andy Armstrong]

"Rob S." wrote:
> 
> > Anyway +1 million on getting some decent docs written. Personally I'd
> > find it useful if someone who is reasonably clueful on the state of TC
> > documentation at the moment could summarise what's out there. The TC
> > book project for example; where's that at?
> 
> I think that falls under my personal category of "too involved to garner
> much continual support".  That's just my thought tho' =)  If we had a solid
> bank of docs and had proven to ourselves that we could even do that 'simple'
> task, then I'd be all for a book.  Lets get some docs out there first ;)

Completely agree -- I'm just trying to get a feel for what's been done
so far on the assumption that there may be useful documentation lying
around out there.

-- 
Andy Armstrong, Tagish

RE: TC4 docs - can we end this?

[Rob S.]

> Anyway +1 million on getting some decent docs written. Personally I'd
> find it useful if someone who is reasonably clueful on the state of TC
> documentation at the moment could summarise what's out there. The TC
> book project for example; where's that at?

I think that falls under my personal category of "too involved to garner
much continual support".  That's just my thought tho' =)  If we had a solid
bank of docs and had proven to ourselves that we could even do that 'simple'
task, then I'd be all for a book.  Lets get some docs out there first ;)

- r

RE: TC4 docs - can we end this?

[Rob S.]

> Just start with it. When you have something, post it as a patch and they
> (Tomcat committers) will have to decide.

It takes a lllong time to write documentation.  I prefer to not shotgun the
docs and hope what I come up with is useful.  It's why I started this whole
thread in the first place! ;)

> IMHO, it would be better to create a tomcat-doc list and let people
> debate all these matters to death, and then perhaps do something. No
> need to have everything pinned up beforehand -- besides, it seems
> impossible to find a consensus.

Well, IMHO =) I think the decision should be up to the TC4 committers (i.e.
people who will deal with the build, edit the docs, etc.).   They seem to
have already decided.

> Use your imagination. What docs would you like to have?

(See my first paragraph above)

> If you don't know where to start, then perhaps this particular task is
> not for you. No offense meant, just that someone must set off with a
> clear mind.

(See my first paragraph above)

- r

RE: Still being flooded with EMAILS!!!!!!!!!!!!!!!!!!!!!!

[Rob S.]

I'm not quite sure that the list owner (that person's email is in the
subscription notice) reads this list.  I've always gotten a response (and
action) from the list owner, it just takes a few days.

Can't you setup a filter in Outlook, Eudora, Pine, whatever, to /null all
"tomcat-dev" messages?  At least until the list owner replies?

- r

> -Original Message-
> From: [EMAIL PROTECTED] [mailto:[EMAIL PROTECTED]]On Behalf Of
> Sebastian Mangels
> Sent: Wednesday, July 04, 2001 6:03 AM
> To: [EMAIL PROTECTED]
> Subject: Still being flooded with EMAILS!!
>
>
> I'm still being flooded with your emails.
>
> just again:
>
> PLEASE GET ME OFF YOUR MAILING LIST.
>
> I DID unsubscribe SEVERAL times. Your mailing system
> did confirm that (I have evidence...) . The owner of your
> mailing list doesn't seem to react. I'm sorry to post again
> in your forum, but I don't see any other chance.
>
> Thanks,
> Sebastian.
>
> Sebastian Mangels schrieb:
>
> > Hi!
> >
> > I did unsubscribe several times (was confirmed by the mailing
> system...).
> > I wrote to the owner of the mailing list to get me off his list...
> > I'm still being flooded with emails.
> >
> > PLEASE, get me off this list.
> >
> > Thanks,
> > Sebastian.
> >
> > --
> > -
> >  Sebastian Mangels
> >  freiheit.com Technologieberatung GmbH
> >  Westend Village, Haus 6a, Loft 636
> >  Theodorstrasse 42-90  Tel.: +49 40 890 584 - 0
> >  22761 Hamburg Fax.: +49 40 890 584 - 20
> > -
>
> --
> -
>  Sebastian Mangels
>  freiheit.com Technologieberatung GmbH
>  Westend Village, Haus 6a, Loft 636
>  Theodorstrasse 42-90  Tel.: +49 40 890 584 - 0
>  22761 Hamburg Fax.: +49 40 890 584 - 20
> -
>
>
>
>

RE: TC4 docs - can we end this?

[Rob S.]

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 [mailto:[EMAIL PROTECTED]]
> Sent: Wednesday, July 04, 2001 2:19 AM
> To: [EMAIL PROTECTED]
> 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
>

Re: Still being flooded with EMAILS!!!!!!!!!!!!!!!!!!!!!!

[Pier P. Fumagalli]

Sebastian Mangels at [EMAIL PROTECTED] wrote:

> I'm still being flooded with your emails.

Those two (no comment) have been removed from the ML.

Re: Still being flooded with EMAILS!!!!!!!!!!!!!!!!!!!!!!

[Pier P. Fumagalli]

Sebastian Mangels at [EMAIL PROTECTED] wrote:

> I'm still being flooded with your emails.
> 
> just again:
> 
>   PLEASE GET ME OFF YOUR MAILING LIST.
> 
>   I DID unsubscribe SEVERAL times. Your mailing system
>   did confirm that (I have evidence...) . The owner of your
>   mailing list doesn't seem to react. I'm sorry to post again
>   in your forum, but I don't see any other chance.

The owner of the mailing list is on vacation... And nobody pays us to do it,
so, bear some respect for those who make you download those nifty software
for free, who do it because they like it and not because they're paid to do
it... Ask politely, and wait...


Pier

Re: Poor Tomcat 3.2.2 performance on Win32 with class reloading enabled

[Stuart Roebuck]

I've been hitting against getCanonicalPath myself recently in the context 
of Cocoon 2 and Tomcat 4 under Mac OS X.

I've taken a look through some of the code of Tomcat and it appears that 
there are opportunities to cut down on calls to getCanonicalPath, but I'm 
conscious that I really am not at all familiar with the code and the 
possible underlying issues.

Here are some examples of bits of code in the current Tomcat source which 
appear open to optimization, perhaps you could comment on whether such 
optimizations would work:

StandardContext.java:

> if (directory.exists() && directory.canRead() &&
> directory.isDirectory()) {
> String filenames[] = directory.list();
> for (int i = 0; i < filenames.length; i++) {
> if (!filenames[i].endsWith(".jar"))
> continue;
> File file = new File(directory, filenames[i]);
> try {
> URL url = new URL("file", null, file.getCanonicalPath(
> ));
> newLoader.addRepository(url.toString());
> } catch (IOException e) {
> throw new IllegalArgumentException(e.toString());
> }
> }
> }

Couldn't we get the Canonical path of the directory and then assume that 
the absolute path of the filenames returned would be Canonical too, 
thereby taking getCanonicalPath out of the loop?

>   // Create this directory if necessary
>   File dir = new File(workDir);
>   if (!dir.isAbsolute()) {
> File catalinaHome = new 
> File(System.getProperty("catalina.home"));
> String catalinaHomePath = null;
> try {
> catalinaHomePath = catalinaHome.getCanonicalPath();
> dir = new File(catalinaHomePath, workDir);
> } catch (IOException e) {
> }
> }

Isn't getAbsolutePath sufficient here?

Similar issues exist in Bootstrap.java.

HostConfig:

> // Deploy the application in this directory
> if (debug >= 1)
> log(sm.getString("hostConfig.deployDir", files[i]));
> try {
> URL url = new URL("file", null, dir.getCanonicalPath(
> ));
> ((Deployer) host).install(contextPath, url);
> } catch (Throwable t) {
> log(sm.getString("hostConfig.deployDir.error", files[
> i]),
> t);
> }

dir is derived using the list method on the appBase variable (not shown on 
listing) which is canonical.  Do we need to use getCanonicalPath here or 
can we just use getAbsolutePath?

Finally, how about having some form of cached getCanonicalPath method 
which returns results from cache for requests for the same file path?  I 
tried replacing the actual getCanonicalPath method in the main Java 
classes with a simple unlimited hashTable and the performance improvements 
running Tomcat and Cocoon were very visible.  Clearly the hash table would 
need to be time and size limited, but are there any other fundamental 
issues with this idea?

Stuart.


On Friday, June 15, 2001, at 10:52  pm, [EMAIL PROTECTED] wrote:

>
> Thanks for the report - if you can think of a patch we can use it for
> 3.2.3. The reloading system has been almost completely rewritten for 3.3,
> with far fewer accesses to the file system.
>
> Have you tried with a different VM ? ( I don't think we can avoid
> getCanonicalPath, is a very useful call and is very important for security
> too )
>
> Costin
>
>
>
>
>
> On Fri, 15 Jun 2001, Brett M. Bergquist wrote:
>
>> I just upgraded or application from Tomcat 3.1 to Tomcat 3.2.2 and
> noticed a dramatic slowdown and increased CPU utilization.  This is on
> WinN  4.0 SP5.  To figure out what was happening, I fired up OptimizeIT
> and  ook a look.  I found that 68% time was being spent in
> "org.apache.tomcat.core.ServletWrapper.handleReload" and of the time
> within this method, 51% of the time was being spent in
> "java.io.File.getCanonicalPath" and of the time spend within this method,
> all of it was spent within "java.io.Win32FileSystem.canonicalize".
>>
>> My question is is this normal and what in the hell is taking so long in
> "java.io.Win32FileSystem.canonacalize"?  Once I disabled class reloading,
> by performance and CPU utilization went back to what was present with
> 3.1.
>>
>> Thanks for any input.
>>
>> Brett M. Bergquist
>> Canoga Perkins Corp.
>>
>


-
Stuart Roebuck, BSc, MBATel.: 0131 228 4853 / Fax.: 0870 054 8322
Managing Director
ADOLOS   

RE: cvs commit: jakarta-tomcat-connectors/jk/native/common jk_ajp14.c jk_service.h jk_worker.c

[Van Ung]

Could some one please remove me from this Forum, I did not subcribe to this.

Thanks,

Van

http://www.pazap.com
t : +44 (0) 1256 869 200
f : +44 (0) 1256 329 119
m : +44 (0)  000 000
e : mailto:[EMAIL PROTECTED]


-Original Message-
From: Monique Salter [mailto:[EMAIL PROTECTED]]
Sent: 04 July 2001 10:29
To: [EMAIL PROTECTED]
Subject: FW: cvs commit: jakarta-tomcat-connectors/jk/native/common
jk_ajp14.c jk_service.h jk_worker.c




-Original Message-
From: [EMAIL PROTECTED] [mailto:[EMAIL PROTECTED]]
Sent: 03 July 2001 22:57
To: [EMAIL PROTECTED]
Subject: cvs commit: jakarta-tomcat-connectors/jk/native/common
jk_ajp14.c jk_service.h jk_worker.c


costin  01/07/03 14:56:50

  Modified:jk/native/common jk_ajp14.c jk_service.h jk_worker.c
  Log:
  - in jk_ajp14, avoid a NPE

  - in jk_service, add a num_of_workers field to workers_env_t, and a
  first_worker. Both will be used to detect if we have a single worker
  ( or default worker ? ). I still need to deal with "lb" configurations,
  where in most cases "lb" is the default worker.

  The idea is that we'll not need to map uri->worker in 99% of the cases
  ( assuming the server is configured to do that ), most people either
  use a single worker or a lb ( but all tomcat requests go to lb ). Special
  configurations are still possible ( for example "/foo" context to go
  to JNI worker, "/bar" to a certain tomcat instance ).

  This is more related with simplifying the manual configuration, using
  SetHandler - if the special JkMount directive is used we can of course
  specify a particular worker.

  Revision  ChangesPath
  1.13  +5 -2  jakarta-tomcat-connectors/jk/native/common/jk_ajp14.c

  Index: jk_ajp14.c
  ===
  RCS file:
/home/cvs/jakarta-tomcat-connectors/jk/native/common/jk_ajp14.c,v
  retrieving revision 1.12
  retrieving revision 1.13
  diff -u -r1.12 -r1.13
  --- jk_ajp14.c2001/07/02 21:14:22 1.12
  +++ jk_ajp14.c2001/07/03 21:56:47 1.13
  @@ -1,3 +1,4 @@
  +/* -*- Mode: C; tab-width: 4; c-basic-offset: 4; indent-tabs-mode: nil-*-
*/
   /*
= *
*
*
* The Apache Software License,  Version 1.1
*
  @@ -58,7 +59,7 @@

/***
* Description: Next generation bi-directional protocol handler.
*
* Author:  Henri Gomez <[EMAIL PROTECTED]>
*
  - * Version: $Revision: 1.12 $
*
  + * Version: $Revision: 1.13 $
*

***/


  @@ -423,7 +424,9 @@
   }

   /* Check if we get the correct virtual host */
  -if (strcmp(c->virtual, vname)) {
  +if (c->virtual != NULL &&
  + vname != NULL &&
  + strcmp(c->virtual, vname)) {
   /* set the virtual name, better to add to a virtual list ? */

   if (context_set_virtual(c, vname) == JK_FALSE) {



  1.7   +5 -1
jakarta-tomcat-connectors/jk/native/common/jk_service.h

  Index: jk_service.h
  ===
  RCS file:
/home/cvs/jakarta-tomcat-connectors/jk/native/common/jk_service.h,v
  retrieving revision 1.6
  retrieving revision 1.7
  diff -u -r1.6 -r1.7
  --- jk_service.h  2001/07/02 21:11:47 1.6
  +++ jk_service.h  2001/07/03 21:56:48 1.7
  @@ -1,3 +1,4 @@
  +/* -*- Mode: C; tab-width: 4; c-basic-offset: 4; indent-tabs-mode: nil-*-
*/
   /*
= *
*
*
* The Apache Software License,  Version 1.1
*
  @@ -62,7 +63,7 @@
* Author:  Gal Shachor <[EMAIL PROTECTED]>
*
* Author:  Dan Milstein <[EMAIL PROTECTED]>
*
* Author:  Henri Gomez <[EMAIL PROTECTED]>
*
  - * Version: $Revision: 1.6 $
*
  + * Version: $Revision: 1.7 $
*

***/

   #ifndef JK_SERVICE_H
  @@ -88,6 +89,9 @@

   /* The URI to WORKER map, will be feeded by AJP14 autoconf feature */
   jk_uri_worker_map_t *uri_to_worker;
  +
  +int num_of_workers;
  +char *first_worker;

   /* Web-Server we're running on (Apache/IIS/NES) */
   char *server_name;



  1.7   +5 -2
jakarta-tomcat-connectors/jk/native/common/jk_worker.c

  Index: jk_worker.c
  ===
  RCS file:
/home/cvs/jakarta-tomcat-connectors/jk/native/common/jk_worker.c,v
  retrieving revision 1.6
  retrieving revision 1.7
  diff -u -r1.6 -r1.7
  --- jk_worker.c   2001/06/22 08:33:56 1.6
  +++ jk_worker.c   2001/07/03 21:56:48 1.7
  @@ -1,3 +1,4 @@
  +/* -*- Mode: C; tab-width: 4; c-basic-offset: 4; indent-tabs-mode: nil-*-
*/
   /*
= 

cvs commit: jakarta-tomcat-connectors/webapp Makefile.in

[jfclere]

jfclere 01/07/04 02:59:36

  Modified:webapp   Makefile.in
  Log:
  Change ./scandoc to ../scandoc (to use scandoc in mod_jk).
  
  Revision  ChangesPath
  1.6   +2 -2  jakarta-tomcat-connectors/webapp/Makefile.in
  
  Index: Makefile.in
  ===
  RCS file: /home/cvs/jakarta-tomcat-connectors/webapp/Makefile.in,v
  retrieving revision 1.5
  retrieving revision 1.6
  diff -u -r1.5 -r1.6
  --- Makefile.in   2001/06/22 09:45:56 1.5
  +++ Makefile.in   2001/07/04 09:59:30 1.6
  @@ -56,7 +56,7 @@
   # = #
   
   # @author  Pier Fumagalli 
  -# @version $Id: Makefile.in,v 1.5 2001/06/22 09:45:56 jfclere Exp $
  +# @version $Id: Makefile.in,v 1.6 2001/07/04 09:59:30 jfclere Exp $
   
   include Makedefs
   
  @@ -104,7 +104,7 @@
   apidocs: include/*.h
@echo "Generating API documentation..."
@if ! test -d docs/api ; then mkdir docs/api ; fi
  - @./scandoc/scandoc.pl -i ./scandoc/template.pl -p ./docs/api/ include/*.h
  + @../scandoc/scandoc.pl -i ../scandoc/template.pl -p ./docs/api/ include/*.h
   
   dist: all apidocs
   
  
  
  

Re: TC4 docs - can we end this?

[Alex Fernández]

Hi Rob!

[quotes in no particular order]

> I would've thought a thread about docs would be concerned with what docs to
> create, what docs will glue them together, maybe an image on the doc
> homepage with a map showing what order you can read them, etc.

Just start with it. When you have something, post it as a patch and they
(Tomcat committers) will have to decide.

IMHO, it would be better to create a tomcat-doc list and let people
debate all these matters to death, and then perhaps do something. No
need to have everything pinned up beforehand -- besides, it seems
impossible to find a consensus.

> As far as Anakia is concerned, it's proven (within Jakarta), it looks a lot
> like XHTML, there's resident expertise, and TC 4 is already using it.  Of
> course I am *all for* debate, discussion, etc. but in lieu of all of the
> above, why continue dicussing it?  What's *wrong*?

You are right, there's nothing wrong with the dozen or so proposals to
format documentation -- except there are so many.

> All of this other bunk is essentially worthless to me.  Tell me what docs to
> create, what's wrong with the ones I'm rewriting or replacing (if that's the
> case), and I'll do it in text or HTML.  Everyone who wants to talk about how
> to render it can deal with it when I'm done - although I have a feeling they
> won't be the ones taking the time to port my output over to whatever format
> they deem reasonable.

Use your imagination. What docs would you like to have?

> 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.

If you don't know where to start, then perhaps this particular task is
not for you. No offense meant, just that someone must set off with a
clear mind.

Un saludo,

Alex.

servlets outside the webapps directory with mod_webapp ?

[Henri Delebecque]

Hello,
I have the following configuration:
Tomcat 4.0 b5
Apache 1.3.19
mod_webapp

I try to reach servlets located outside the webapps directory,
not directly with Tomcat, but using Apache.
I have read the jakarta.apache.org/tomcat/tomcat-4.0-doc/appdev/deployment.html
page.

I try to define a Context, like I made previously with
the mod_jk connecting module, in the server.xml file, in
the Apache-Connector Service part of it, as it is said in the html page
mentioned above. But this page says that I should include the Context
clause after the last one of the file. This file doesn't have any Context
clause in the Apache-Connector Service section...
 I have included this line, as a child of the  element:

Unfortunately, Tomcat refuses this declaration, even if I include it
in a ..  section, like
it is done in the Tomcat-Standalone Service description. In both
case, the error message is the same:

"ERROR reading bin/../conf/server.xml
At Line 330 /Server/Service/Engine/Host/
Catalina.start: InvocationTargetException
java.lang.IllegalArgumentException: Child is not a WarpHost"


Thanks a lot for any help

__
| Henri Delebecque[EMAIL PROTECTED] |
| Webmaster   |
| Supelec  Tel (33)  01.69.85.14.91   |
| 3 rue Joliot-Curie  |
| Plateau de Moulon Fax:(33) 01.69.85.12.34   |
| 91190 Gif sur Yvette|
| FRANCE  |
|_|

__
| Henri Delebecque[EMAIL PROTECTED] |
| Webmaster   |
| Supelec  Tel (33)  01.69.85.14.91   |
| 3 rue Joliot-Curie  |
| Plateau de Moulon Fax:(33) 01.69.85.12.34   |
| 91190 Gif sur Yvette|
| FRANCE  |
|_|

Re: TC4 docs - can we end this?

[Andy Armstrong]

"Rob S." wrote:
> 
> (apologies in advance for the tone, I'm a happy person =)
> 
> As far as Anakia is concerned, it's proven (within Jakarta), it looks a lot
> like XHTML, there's resident expertise, and TC 4 is already using it.  Of
> course I am *all for* debate, discussion, etc. but in lieu of all of the
> above, why continue dicussing it?  What's *wrong*?
> 
> I dunno who said it, but a long time ago there's a nice quote I heard in
> English class, "The purity of a revolution lasts for about two weeks."  It
> explains what happens each time we talk about docs, a nice(r) admin UI, etc.
> It seems like people are more interested in talking about what projects to
> create, what tools to use, etc. when I *still* haven't read any comments
> about *THE ACTUAL DOCUMENTATION* aside from "TOMCAT SUCKS!" and everyone's
> agreement that the docs are in need of repair...  Not a lot of
> groundbreaking realizations left to make on those two points.

You have, of course, put your finger on the reason why so many free
software projects have sucky docs -- we'd all far rather fantasize about
high falutin tools than put finger to keyboard. Talking about the tools
is just another reason to delay writing the docs.

Anyway +1 million on getting some decent docs written. Personally I'd
find it useful if someone who is reasonably clueful on the state of TC
documentation at the moment could summarise what's out there. The TC
book project for example; where's that at?

-- 
Andy Armstrong, Tagish

Still being flooded with EMAILS!!!!!!!!!!!!!!!!!!!!!!

[Sebastian Mangels]

I'm still being flooded with your emails.

just again:

PLEASE GET ME OFF YOUR MAILING LIST.

I DID unsubscribe SEVERAL times. Your mailing system
did confirm that (I have evidence...) . The owner of your
mailing list doesn't seem to react. I'm sorry to post again
in your forum, but I don't see any other chance.

Thanks,
Sebastian.

Sebastian Mangels schrieb:

> Hi!
>
> I did unsubscribe several times (was confirmed by the mailing system...).
> I wrote to the owner of the mailing list to get me off his list...
> I'm still being flooded with emails.
>
> PLEASE, get me off this list.
>
> Thanks,
> Sebastian.
>
> --
> -
>  Sebastian Mangels
>  freiheit.com Technologieberatung GmbH
>  Westend Village, Haus 6a, Loft 636
>  Theodorstrasse 42-90  Tel.: +49 40 890 584 - 0
>  22761 Hamburg Fax.: +49 40 890 584 - 20
> -

--
-
 Sebastian Mangels
 freiheit.com Technologieberatung GmbH
 Westend Village, Haus 6a, Loft 636
 Theodorstrasse 42-90  Tel.: +49 40 890 584 - 0
 22761 Hamburg Fax.: +49 40 890 584 - 20
-

Implementation error in /org/apache/tomcat/core/RequestImpl.java !?

[hoelkeskamp]

Hi,
I'm working with Tomcat 3.2.2 and tried to run OpenCMS. In some cases
Tomcat throws a nullpointer-exception, which is obviously caused by  the

line :
  context.log("RequestImpl: no session created!");
in file /org/apache/tomcat/core/RequestImpl.java
According to your version of Tomcat it can be fount near line 480. It is

the only one of its kind which isn't commented out.
After commenting this line of code and recompiling Tomcat everything
worked fine. So now my question is:
Is this an error in the Implementation?

Comments would be appreciated.

Thanks in advance,
Andreas