[DOC] TC4 Status

2001-07-29 Thread Rob S.

Was there ever any resolution to the docs discussion on -general?  I wish I
could contribute to a doc gen or format tool conversation, but I'm far from
an expert in that field.  Standing up and waving my arms about the whole
topic probably isn't going to do much either, so I'll talk about something
else for now =)

Right now, the current structure of the docs (index.xml) looks like this:

- Introduction
- Getting Started
- Administrators
- App Developers
- Tomcat Developers

The Introduction and Getting Started sections are pretty much done -
there are documents on building, installing, and running Tomcat in there
now.  Craig is working on porting the App Developers guide this weekend.

What's the top priority for the Administrators section?  Did anyone take a
look at the Running Multiple Instances thing?  Was that like, too
worthless to even comment on? =)

- r




Non-web .jsp templates ?

2001-07-29 Thread Deacon Marcus

Hi,
Our team was recently discussing potential usage of .jsp pages as templates
for use with automatic mail generation and other automated tasks when the
result is not sent via http but stored and/or processed. Are there any
(open-source preffered) projects (taglibs?) with similar goals? If not, do
you think it's something with enough demand to release it when it's
late-beta?
The discussed approach was to include a jsp-template inside of a custom tag
redirecting it to a specified e-mail address/list on an itermediate (process
and forward type) jsp page.

Greetings, deacon Marcus




Re: Non-web .jsp templates ?

2001-07-29 Thread Jim Seach

Why not user Velocity?  It is already set up to do
this, and even has an ant task (Texen) to help
automate it.

Jim

--- Deacon Marcus [EMAIL PROTECTED] wrote:
 Hi,
 Our team was recently discussing potential usage of
 .jsp pages as templates
 for use with automatic mail generation and other
 automated tasks when the
 result is not sent via http but stored and/or
 processed. Are there any
 (open-source preffered) projects (taglibs?) with
 similar goals? If not, do
 you think it's something with enough demand to
 release it when it's
 late-beta?
 The discussed approach was to include a jsp-template
 inside of a custom tag
 redirecting it to a specified e-mail address/list on
 an itermediate (process
 and forward type) jsp page.
 
 Greetings, deacon Marcus
 


__
Do You Yahoo!?
Make international calls for as low as $.04/minute with Yahoo! Messenger
http://phonecard.yahoo.com/



Re: Non-web .jsp templates ?

2001-07-29 Thread Nick Bauman

I've actually done what you describe. After building a half-assed version 
using JSP, I abandoned it in favor or Velocity. The Velocity version ended 
up being 1/2 the complexity of the JSP version because of the difficulty in 
embedding a servlet engine into a component which is using an RMI protocol. 
(otherwise, talking to your mail templates over a socket using HTTP is 
pretty lame)

It comes down to one very powerful thing Velocity has over JSP: it's 
completely uncoupled from any servlet technology.

 Hi,
 Our team was recently discussing potential usage of .jsp pages as
 templates for use with automatic mail generation and other automated
 tasks when the result is not sent via http but stored and/or processed.
 Are there any (open-source preffered) projects (taglibs?) with similar
 goals? If not, do you think it's something with enough demand to
 release it when it's late-beta?
 The discussed approach was to include a jsp-template inside of a custom
 tag redirecting it to a specified e-mail address/list on an itermediate
 (process and forward type) jsp page.
 
 Greetings, deacon Marcus


-- 
Nick Bauman
Software Engineer
3600 Dupont
Minneapolis, MN
55412
Mobile Phone: (612) 232-7120
Home Phone: (612) 522-0165




cvs commit: jakarta-tomcat-4.0/webapps/tomcat-docs/appdev/sample/src/mypackage - New directory

2001-07-29 Thread craigmcc

craigmcc01/07/29 15:23:38

  jakarta-tomcat-4.0/webapps/tomcat-docs/appdev/sample/src/mypackage - New directory



Re: [DOC] TC4 Status

2001-07-29 Thread Craig R. McClanahan

On Sun, 29 Jul 2001, Rob S. wrote:

 Was there ever any resolution to the docs discussion on -general?  I wish I
 could contribute to a doc gen or format tool conversation, but I'm far from
 an expert in that field.  Standing up and waving my arms about the whole
 topic probably isn't going to do much either, so I'll talk about something
 else for now =)
 

It's not formally resolved, but it's time for us to just do
something instead of just talk about it.

 Right now, the current structure of the docs (index.xml) looks like this:
 
 - Introduction
 - Getting Started
 - Administrators
 - App Developers
 - Tomcat Developers
 
 The Introduction and Getting Started sections are pretty much done -
 there are documents on building, installing, and running Tomcat in there
 now.  Craig is working on porting the App Developers guide this weekend.
 

You can see the fruits of my labors in the tomcat-docs web app.  This
can be generated (if you've got the source distribution) by typing ant
tomcat-docs at the top level.  I'm also going to upload a snapshot of the
output to the Tomcat web site for easy perusal.

If you've got some text, I'd like to try integrating it into the
tomcat-docs experiment.  The Anakia stylesheet that was written for
jakarta-site2 (and therefore the XSLT version that I checked in, because I
tried to be as similar as possible) has some real quirks when you try to
use it for different projects -- but the document content itself should be
able to be pretty independent of that.

You'll also note that I punted on the Getting Started and just linked in
the text files from the top-level directory of the distribution.  I'm fine
with doing whatever's appropriate, but we do need *something* in text-only
format there, and we should minimize duplication that will require things
to be updated more than once later.

 What's the top priority for the Administrators section?

IMHO, documenting the various settings in server.xml is critical.  It
really needs to be done in at least two flavors -- reference material on
all the possible options (pretty much done in HTML, needs to be
converted), and a more user's guide approach to if you want to do
this, here's how you do it.

The current docs try to mix these styles a little, and I'm not so sure it
is very effective.

  Did anyone take a
 look at the Running Multiple Instances thing?  Was that like, too
 worthless to even comment on? =)
 

It's on my list to look at, honest!  As a general organizational note, are
you thinking of having a section of the Administrator's Guide for one
pager topics like this?  Or are you thinking these are more chapters or
sections in something that feels like one overall document?

 - r
 
 
Craig





cvs commit: jakarta-tomcat-site/xdocs/stylesheets project.xml

2001-07-29 Thread craigmcc

craigmcc01/07/29 15:50:34

  Modified:docs index.html news.html
   xdocs/stylesheets project.xml
  Log:
  Add a link to the experimental tomcat-docs web app for Tomcat 4.0.  To
  actually populate that directory, just upload the generated
  tomcat-docs.war into /www/jakarta.apache.org/tomcat/tomcat-4.0-doc-exp
  and unJAR it.
  
  Revision  ChangesPath
  1.5   +3 -1  jakarta-tomcat-site/docs/index.html
  
  Index: index.html
  ===
  RCS file: /home/cvs/jakarta-tomcat-site/docs/index.html,v
  retrieving revision 1.4
  retrieving revision 1.5
  diff -u -r1.4 -r1.5
  --- index.html2001/07/20 12:50:51 1.4
  +++ index.html2001/07/29 22:50:34 1.5
  @@ -50,7 +50,9 @@
   /li
   lia href=./tomcat-3.3-doc/index.htmlTomcat 3.3/a
   /li
  -lia href=./tomcat-4.0-doc/index.htmlTomcat 4.0/a
  +lia href=./tomcat-4.0-doc/index.htmlTomcat 4.0 
(current)/a
  +/li
  +lia href=./tomcat-4.0-doc-exp/index.htmlTomcat 4.0 
(experimental)/a
   /li
   /ul
   pstrongDownload/strong/p
  
  
  
  1.5   +3 -1  jakarta-tomcat-site/docs/news.html
  
  Index: news.html
  ===
  RCS file: /home/cvs/jakarta-tomcat-site/docs/news.html,v
  retrieving revision 1.4
  retrieving revision 1.5
  diff -u -r1.4 -r1.5
  --- news.html 2001/07/17 18:25:16 1.4
  +++ news.html 2001/07/29 22:50:34 1.5
  @@ -50,7 +50,9 @@
   /li
   lia href=./tomcat-3.3-doc/index.htmlTomcat 3.3/a
   /li
  -lia href=./tomcat-4.0-doc/index.htmlTomcat 4.0/a
  +lia href=./tomcat-4.0-doc/index.htmlTomcat 4.0 
(current)/a
  +/li
  +lia href=./tomcat-4.0-doc-exp/index.htmlTomcat 4.0 
(experimental)/a
   /li
   /ul
   pstrongDownload/strong/p
  
  
  
  1.2   +3 -1  jakarta-tomcat-site/xdocs/stylesheets/project.xml
  
  Index: project.xml
  ===
  RCS file: /home/cvs/jakarta-tomcat-site/xdocs/stylesheets/project.xml,v
  retrieving revision 1.1
  retrieving revision 1.2
  diff -u -r1.1 -r1.2
  --- project.xml   2001/05/22 17:31:21 1.1
  +++ project.xml   2001/07/29 22:50:34 1.2
  @@ -14,7 +14,9 @@
   menu name=Documentation
   item name=Tomcat 3.2   href=/tomcat-3.2-doc/index.html/ 
   item name=Tomcat 3.3   href=/tomcat-3.3-doc/index.html/ 
  -item name=Tomcat 4.0   href=/tomcat-4.0-doc/index.html/ 
  +item name=Tomcat 4.0 (current) href=/tomcat-4.0-doc/index.html/ 
  +item name=Tomcat 4.0 (experimental)
  +href=/tomcat-4.0-doc-exp/index.html/
   /menu
   
   menu name=Download
  
  
  



cvs commit: jakarta-tomcat/src/share/org/apache/tomcat/util DateTool.java MimeHeaderField.java

2001-07-29 Thread marcsaeg

marcsaeg01/07/29 17:57:34

  Modified:src/share/org/apache/tomcat/service/http Tag: tomcat_32
HttpResponseAdapter.java
   src/share/org/apache/tomcat/util Tag: tomcat_32
DateTool.java MimeHeaderField.java
  Log:
  A Date: header is now sent in the response when Tomcat is running stand-alone.
  
  Also fixes a bug in the previous date formats that had a 5 digit date format
  (y) that caused a leading zero at the front of the years (e.g. 02001).
  
  PR: 345
  Submitted by: GOMEZ Henri [[EMAIL PROTECTED]]
  
  Revision  ChangesPath
  No   revision
  
  
  No   revision
  
  
  1.11.2.2  +4 -4  
jakarta-tomcat/src/share/org/apache/tomcat/service/http/Attic/HttpResponseAdapter.java
  
  Index: HttpResponseAdapter.java
  ===
  RCS file: 
/home/cvs/jakarta-tomcat/src/share/org/apache/tomcat/service/http/Attic/HttpResponseAdapter.java,v
  retrieving revision 1.11.2.1
  retrieving revision 1.11.2.2
  diff -u -r1.11.2.1 -r1.11.2.2
  --- HttpResponseAdapter.java  2000/11/07 03:16:50 1.11.2.1
  +++ HttpResponseAdapter.java  2001/07/30 00:57:34 1.11.2.2
  @@ -1,7 +1,7 @@
   /*
  - * $Header: 
/home/cvs/jakarta-tomcat/src/share/org/apache/tomcat/service/http/Attic/HttpResponseAdapter.java,v
 1.11.2.1 2000/11/07 03:16:50 craigmcc Exp $
  - * $Revision: 1.11.2.1 $
  - * $Date: 2000/11/07 03:16:50 $
  + * $Header: 
/home/cvs/jakarta-tomcat/src/share/org/apache/tomcat/service/http/Attic/HttpResponseAdapter.java,v
 1.11.2.2 2001/07/30 00:57:34 marcsaeg Exp $
  + * $Revision: 1.11.2.2 $
  + * $Date: 2001/07/30 00:57:34 $
*
* 
*
  @@ -143,7 +143,7 @@
// This avoids redundant setting of date ( very expensive ).
// XXX XXX Check if IIS, NES do generate the date
MimeHeaderField dateH= headers.find( Date );
  - if( false  dateH == null ) {
  + if( dateH == null ) {
// no date header set by user
dateH=headers.putHeader();
dateH.setName(Date);
  
  
  
  No   revision
  
  
  No   revision
  
  
  1.2.2.1   +19 -5 
jakarta-tomcat/src/share/org/apache/tomcat/util/Attic/DateTool.java
  
  Index: DateTool.java
  ===
  RCS file: 
/home/cvs/jakarta-tomcat/src/share/org/apache/tomcat/util/Attic/DateTool.java,v
  retrieving revision 1.2
  retrieving revision 1.2.2.1
  diff -u -r1.2 -r1.2.2.1
  --- DateTool.java 2000/05/24 16:34:20 1.2
  +++ DateTool.java 2001/07/30 00:57:34 1.2.2.1
  @@ -1,7 +1,7 @@
   /*
  - * $Header: 
/home/cvs/jakarta-tomcat/src/share/org/apache/tomcat/util/Attic/DateTool.java,v 1.2 
2000/05/24 16:34:20 costin Exp $
  - * $Revision: 1.2 $
  - * $Date: 2000/05/24 16:34:20 $
  + * $Header: 
/home/cvs/jakarta-tomcat/src/share/org/apache/tomcat/util/Attic/DateTool.java,v 
1.2.2.1 2001/07/30 00:57:34 marcsaeg Exp $
  + * $Revision: 1.2.2.1 $
  + * $Date: 2001/07/30 00:57:34 $
*
* 
*
  @@ -94,7 +94,7 @@
   /** format for RFC 1123 date string -- Sun, 06 Nov 1994 08:49:37 GMT
*/
   public final static String RFC1123_PATTERN =
  -EEE, dd MMM y HH:mm:ss z;
  +EEE, dd MMM  HH:mm:ss z;
   
   // format for RFC 1036 date string -- Sunday, 06-Nov-94 08:49:37 GMT
   private final static String rfc1036Pattern =
  @@ -102,7 +102,7 @@
   
   // format for C asctime() date string -- Sun Nov  6 08:49:37 1994
   private final static String asctimePattern =
  -EEE MMM d HH:mm:ss y;
  +EEE MMM d HH:mm:ss ;
   
   /** Pattern used for old cookies
*/
  @@ -131,4 +131,18 @@
asctimeFormat.setTimeZone(GMT_ZONE);
   }
   
  +private static String rfc1123DS;
  +private static long   rfc1123Sec;
  +
  +/**
  + */
  +public static String format1123( Date d ) {
  +long dt = d.getTime() % 1000;
  +if ((rfc1123DS != null)  (dt == rfc1123Sec))
  +return rfc1123DS;
  +
  +rfc1123DS  = rfc1123Format.format( d );
  +rfc1123Sec = dt;
  +return rfc1123DS;
  +}
   }
  
  
  
  1.10.2.3  +4 -4  
jakarta-tomcat/src/share/org/apache/tomcat/util/Attic/MimeHeaderField.java
  
  Index: MimeHeaderField.java
  ===
  RCS file: 
/home/cvs/jakarta-tomcat/src/share/org/apache/tomcat/util/Attic/MimeHeaderField.java,v
  retrieving revision 1.10.2.2
  retrieving revision 1.10.2.3
  diff -u -r1.10.2.2 -r1.10.2.3
  --- MimeHeaderField.java  2000/11/10 06:42:52 1.10.2.2
  +++ MimeHeaderField.java  2001/07/30 00:57:34 1.10.2.3
  @@ -1,7 +1,7 @@
   /*
  - * $Header: