You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@tomcat.apache.org by ma...@apache.org on 2005/09/09 00:13:50 UTC
svn commit: r279657 - in /tomcat/site/trunk: docs/findhelp.html
docs/whichversion.html xdocs/findhelp.xml xdocs/whichversion.xml
Author: markt
Date: Thu Sep 8 15:13:43 2005
New Revision: 279657
URL: http://svn.apache.org/viewcvs?rev=279657&view=rev
Log:
Fill in some of the blanks
Modified:
tomcat/site/trunk/docs/findhelp.html
tomcat/site/trunk/docs/whichversion.html
tomcat/site/trunk/xdocs/findhelp.xml
tomcat/site/trunk/xdocs/whichversion.xml
Modified: tomcat/site/trunk/docs/findhelp.html
URL: http://svn.apache.org/viewcvs/tomcat/site/trunk/docs/findhelp.html?rev=279657&r1=279656&r2=279657&view=diff
==============================================================================
--- tomcat/site/trunk/docs/findhelp.html (original)
+++ tomcat/site/trunk/docs/findhelp.html Thu Sep 8 15:13:43 2005
@@ -76,7 +76,7 @@
<a href="./faq/">FAQ</a>
</li>
<li>
-<a href="./mail.html">Mailing Lists</a>
+<a href="./lists.html#tomcat-user">Mailing Lists</a>
</li>
<li>
<a href="./bugreport.html">Bug Database</a>
@@ -143,8 +143,8 @@
<tr>
<td bgcolor="#525D76">
<font face="arial,helvetica,sanserif" color="#ffffff">
-<a name="TODO">
-<strong>TODO</strong>
+<a name="Find help">
+<strong>Find help</strong>
</a>
</font>
</td>
@@ -153,8 +153,52 @@
<td>
<p>
<blockquote>
-<p>Summary of ways to get help. What each one is, how and when it should
-be used etc.</p>
+
+<p>Apache Tomcat support is provided by the community, for the community, on a
+purely volunteer basis. This page has been written to help you find the help you
+need whilst making the most efficient use of the resources available. The types
+of help are presented in the same order they are typically used.</p>
+
+<p>The first resource to check is the documentation. As well as the Tomcat
+documentation (make sure you check the documentation for the version you are
+using) you should also check the relevant Servlet and/or JSP version. Much of
+Tomcat's behaviour is determined by these specifcations and the information in
+them is not typically duplciated in the Tomcat documentation.</p>
+
+<p>The logs which Apache Tomcat generates can be a valuable resource when trying
+to diagnose a problem. Please review them. You may want to enable debug output
+in your Apache Tomcat configuration so that you have more information to help
+diagnose the problem.</p>
+
+<p>It is unusual to find a problem that no-one else has seen. The chances are
+that your question has been asked and answered by somebody else. Use your
+favourite search engine to try and find it.</p>
+
+<p>Answers to very common questions are documented on the
+<a href="/faq/">FAQ</a>
+</p>.
+
+<p>The archives for the user mailing list are a rich source of useful
+information. Use the search features provided by one of them. A
+<a href="list.html">selection of archives</a> is provided on the mailing list
+page.</p>
+
+<p>If you have already subscribed to the
+<a href="mailto:tomcat-user@jakarta.apache.org">tomcat-user</a> or
+<a href="mailto:tomcat-dev@jakarta.apache.org">tomcat-dev</a> discussion lists
+you can ask about the problem on those lists. If you are not subscribed, you
+will need to subscribe before you can send your question to either of these
+lists. The <a href="list.html">mailing list</a> pages provide further
+information on how to use the mailing lists as well as subscription
+instructions.</p>
+
+<p>If you think you have found a bug, please following the
+<a href="bugreporting.html">bug reporting</a> steps. Particularly if you are
+using an older version of Apache Tomcat, there is a good chance that the
+problem has been fixed so it is always worth searching the bug database to
+see if ths is the case.</p>
+
+<p>There is also an <a href="irc.html">IRC channel</a> dedicated to Tomcat.</p>
</blockquote>
</p>
Modified: tomcat/site/trunk/docs/whichversion.html
URL: http://svn.apache.org/viewcvs/tomcat/site/trunk/docs/whichversion.html?rev=279657&r1=279656&r2=279657&view=diff
==============================================================================
--- tomcat/site/trunk/docs/whichversion.html (original)
+++ tomcat/site/trunk/docs/whichversion.html Thu Sep 8 15:13:43 2005
@@ -80,7 +80,7 @@
<a href="./faq/">FAQ</a>
</li>
<li>
-<a href="./mail.html">Mailing Lists</a>
+<a href="./lists.html#tomcat-user">Mailing Lists</a>
</li>
<li>
<a href="./bugreport.html">Bug Database</a>
@@ -217,6 +217,53 @@
community-driven support approach, the older your version the less people would
be interested or able to support you.
</p>
+
+</blockquote>
+</p>
+</td>
+</tr>
+<tr>
+<td>
+<br />
+</td>
+</tr>
+</table>
+<table width="100%" cellpadding="2" cellspacing="0" border="0">
+<tr>
+<td bgcolor="#525D76">
+<font face="arial,helvetica,sanserif" color="#ffffff">
+<a name="Alpha / Beta / Stable">
+<strong>Alpha / Beta / Stable</strong>
+</a>
+</font>
+</td>
+</tr>
+<tr>
+<td>
+<p>
+<blockquote>
+
+<p>Every Tomcat release is initially released as an Alpha release. After a week or
+so of testing a vote is held to gather views on the stability of the release. If a
+major issue is identified during testing, then the vote may not take place and the
+release will remain as an Alpha release.</p>
+
+<p>Stability is a subjective judgement and you should always read carefully the
+release notes for any version you intend to make use of.</p>
+
+<p>
+<strong>Alpha</strong> releases may contain large amounts of untested/missing
+functionality required by the specification and/or signifcant bugs and are not
+expected to run stably for any length of time.</p>
+
+<p>
+<strong>Beta</strong> releases may contain some untested functionlaity and/or a
+number of relatively minor bugs. Beta releases are not expected to run stably.</p>
+
+<p>
+<strong>Stable</strong> releases may contain a small number of relatively minor
+bugs. Stable releases are intended for production use and are expected to run
+stably for extended periods of time.</p>
</blockquote>
</p>
Modified: tomcat/site/trunk/xdocs/findhelp.xml
URL: http://svn.apache.org/viewcvs/tomcat/site/trunk/xdocs/findhelp.xml?rev=279657&r1=279656&r2=279657&view=diff
==============================================================================
--- tomcat/site/trunk/xdocs/findhelp.xml (original)
+++ tomcat/site/trunk/xdocs/findhelp.xml Thu Sep 8 15:13:43 2005
@@ -7,9 +7,52 @@
<body>
-<section name="TODO">
-<p>Summary of ways to get help. What each one is, how and when it should
-be used etc.</p>
+<section name="Find help">
+
+<p>Apache Tomcat support is provided by the community, for the community, on a
+purely volunteer basis. This page has been written to help you find the help you
+need whilst making the most efficient use of the resources available. The types
+of help are presented in the same order they are typically used.</p>
+
+<p>The first resource to check is the documentation. As well as the Tomcat
+documentation (make sure you check the documentation for the version you are
+using) you should also check the relevant Servlet and/or JSP version. Much of
+Tomcat's behaviour is determined by these specifcations and the information in
+them is not typically duplciated in the Tomcat documentation.</p>
+
+<p>The logs which Apache Tomcat generates can be a valuable resource when trying
+to diagnose a problem. Please review them. You may want to enable debug output
+in your Apache Tomcat configuration so that you have more information to help
+diagnose the problem.</p>
+
+<p>It is unusual to find a problem that no-one else has seen. The chances are
+that your question has been asked and answered by somebody else. Use your
+favourite search engine to try and find it.</p>
+
+<p>Answers to very common questions are documented on the
+<a href="/faq/">FAQ</a></p>.
+
+<p>The archives for the user mailing list are a rich source of useful
+information. Use the search features provided by one of them. A
+<a href="list.html">selection of archives</a> is provided on the mailing list
+page.</p>
+
+<p>If you have already subscribed to the
+<a href="mailto:tomcat-user@jakarta.apache.org">tomcat-user</a> or
+<a href="mailto:tomcat-dev@jakarta.apache.org">tomcat-dev</a> discussion lists
+you can ask about the problem on those lists. If you are not subscribed, you
+will need to subscribe before you can send your question to either of these
+lists. The <a href="list.html">mailing list</a> pages provide further
+information on how to use the mailing lists as well as subscription
+instructions.</p>
+
+<p>If you think you have found a bug, please following the
+<a href="bugreporting.html">bug reporting</a> steps. Particularly if you are
+using an older version of Apache Tomcat, there is a good chance that the
+problem has been fixed so it is always worth searching the bug database to
+see if ths is the case.</p>
+
+<p>There is also an <a href="irc.html">IRC channel</a> dedicated to Tomcat.</p>
</section>
Modified: tomcat/site/trunk/xdocs/whichversion.xml
URL: http://svn.apache.org/viewcvs/tomcat/site/trunk/xdocs/whichversion.xml?rev=279657&r1=279656&r2=279657&view=diff
==============================================================================
--- tomcat/site/trunk/xdocs/whichversion.xml (original)
+++ tomcat/site/trunk/xdocs/whichversion.xml Thu Sep 8 15:13:43 2005
@@ -53,6 +53,29 @@
</section>
+<section name="Alpha / Beta / Stable">
+
+<p>Every Tomcat release is initially released as an Alpha release. After a week or
+so of testing a vote is held to gather views on the stability of the release. If a
+major issue is identified during testing, then the vote may not take place and the
+release will remain as an Alpha release.</p>
+
+<p>Stability is a subjective judgement and you should always read carefully the
+release notes for any version you intend to make use of.</p>
+
+<p><strong>Alpha</strong> releases may contain large amounts of untested/missing
+functionality required by the specification and/or signifcant bugs and are not
+expected to run stably for any length of time.</p>
+
+<p><strong>Beta</strong> releases may contain some untested functionlaity and/or a
+number of relatively minor bugs. Beta releases are not expected to run stably.</p>
+
+<p><strong>Stable</strong> releases may contain a small number of relatively minor
+bugs. Stable releases are intended for production use and are expected to run
+stably for extended periods of time.</p>
+
+</section>
+
<section name="Apache Tomcat 5.x">
<p><strong>Apache Tomcat 5.5.x</strong>. Apache Tomcat 5.5 is the current focus of
---------------------------------------------------------------------
To unsubscribe, e-mail: tomcat-dev-unsubscribe@jakarta.apache.org
For additional commands, e-mail: tomcat-dev-help@jakarta.apache.org
Re: svn commit: r279657 - in /tomcat/site/trunk: docs/findhelp.html
docs/whichversion.html xdocs/findhelp.xml xdocs/whichversion.xml
Posted by Mark Thomas <ma...@apache.org>.
Rahul Akolkar wrote:
> Looking at this commit, it seems you might want to get some sweeping
> propset's in on svn:eol-style, and use these as auto-props for future
> svn additions, if you don't already [
> http://www.apache.org/dev/svn-eol-style.txt ].
Thanks for the tip - I hadn't spotted that.
> I also wonder why the CGI's from last night now bear LFs for eol-style
> (r279457,r279458). Can those be changed to native?
My bad. I'll fix them now.
> Thanks for all the work. Just trying to save some grief later ;-)
Indeed. Your help is appreciated.
Mark
---------------------------------------------------------------------
To unsubscribe, e-mail: tomcat-dev-unsubscribe@jakarta.apache.org
For additional commands, e-mail: tomcat-dev-help@jakarta.apache.org
Re: svn commit: r279657 - in /tomcat/site/trunk: docs/findhelp.html docs/whichversion.html xdocs/findhelp.xml xdocs/whichversion.xml
Posted by Rahul Akolkar <ra...@gmail.com>.
On 9/8/05, markt@apache.org <ma...@apache.org> wrote:
> Author: markt
> Date: Thu Sep 8 15:13:43 2005
> New Revision: 279657
<snip/>
Mark -
Looking at this commit, it seems you might want to get some sweeping
propset's in on svn:eol-style, and use these as auto-props for future
svn additions, if you don't already [
http://www.apache.org/dev/svn-eol-style.txt ].
I also wonder why the CGI's from last night now bear LFs for eol-style
(r279457,r279458). Can those be changed to native?
Thanks for all the work. Just trying to save some grief later ;-)
-Rahul
---------------------------------------------------------------------
To unsubscribe, e-mail: tomcat-dev-unsubscribe@jakarta.apache.org
For additional commands, e-mail: tomcat-dev-help@jakarta.apache.org