[DOC] TC4 Status
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 ?
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 ?
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 ?
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
craigmcc01/07/29 15:23:38 jakarta-tomcat-4.0/webapps/tomcat-docs/appdev/sample/src/mypackage - New directory
Re: [DOC] TC4 Status
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
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
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: