tomcat-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From ma...@apache.org
Subject svn commit: r675788 - in /tomcat: container/tc5.5.x/webapps/docs/config/project.xml container/tc5.5.x/webapps/docs/config/systemprops.xml container/tc5.5.x/webapps/docs/tomcat-docs.xsl current/tc5.5.x/STATUS.txt
Date Thu, 10 Jul 2008 22:27:41 GMT
Author: markt
Date: Thu Jul 10 15:27:41 2008
New Revision: 675788

URL: http://svn.apache.org/viewvc?rev=675788&view=rev
Log:
Apply a pure doc patch. (I need this for another patch I am working on).

Added:
    tomcat/container/tc5.5.x/webapps/docs/config/systemprops.xml   (with props)
Modified:
    tomcat/container/tc5.5.x/webapps/docs/config/project.xml
    tomcat/container/tc5.5.x/webapps/docs/tomcat-docs.xsl
    tomcat/current/tc5.5.x/STATUS.txt

Modified: tomcat/container/tc5.5.x/webapps/docs/config/project.xml
URL: http://svn.apache.org/viewvc/tomcat/container/tc5.5.x/webapps/docs/config/project.xml?rev=675788&r1=675787&r2=675788&view=diff
==============================================================================
--- tomcat/container/tc5.5.x/webapps/docs/config/project.xml (original)
+++ tomcat/container/tc5.5.x/webapps/docs/config/project.xml Thu Jul 10 15:27:41 2008
@@ -57,6 +57,9 @@
         <item name="Valve"                 href="valve.html"/>
     </menu>
 
+    <menu name="Global Settings">
+        <item name="System properties"     href="systemprops.html"/>
+    </menu>
   </body>
 
 </project>

Added: tomcat/container/tc5.5.x/webapps/docs/config/systemprops.xml
URL: http://svn.apache.org/viewvc/tomcat/container/tc5.5.x/webapps/docs/config/systemprops.xml?rev=675788&view=auto
==============================================================================
--- tomcat/container/tc5.5.x/webapps/docs/config/systemprops.xml (added)
+++ tomcat/container/tc5.5.x/webapps/docs/config/systemprops.xml Thu Jul 10 15:27:41 2008
@@ -0,0 +1,173 @@
+<?xml version="1.0"?>
+<!--
+  Licensed to the Apache Software Foundation (ASF) under one or more
+  contributor license agreements.  See the NOTICE file distributed with
+  this work for additional information regarding copyright ownership.
+  The ASF licenses this file to You under the Apache License, Version 2.0
+  (the "License"); you may not use this file except in compliance with
+  the License.  You may obtain a copy of the License at
+
+      http://www.apache.org/licenses/LICENSE-2.0
+
+  Unless required by applicable law or agreed to in writing, software
+  distributed under the License is distributed on an "AS IS" BASIS,
+  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  See the License for the specific language governing permissions and
+  limitations under the License.
+-->
+<!DOCTYPE document [
+  <!ENTITY project SYSTEM "project.xml">
+]>
+<document url="systemprops.html">
+
+  &project;
+
+  <properties>
+    <title>System Properties</title>
+  </properties>
+
+<body>
+
+<section name="Introduction">
+  <p>The follow sections list the system properties that may be set to modify
+  the default Tomcat behaviour.</p>
+</section>
+
+
+
+<section name="Jasper">
+  <properties>
+
+    <property name="org.apache.jasper.runtime. BodyContentImpl.LIMIT_BUFFER">
+      <p>If <code>true</code>, any tag buffer that expands beyond
+      <code>org.apache.jasper.Constants.DEFAULT_TAG_BUFFER_SIZE</code> will be
+      destroyed and a new buffer created of the default size. If not specified,
+      the default value of <code>false</code> will be used.</p>
+    </property>
+
+    <property name="org.apache.jasper.runtime. JspFactoryImpl.USE_POOL">
+      <p>If <code>true</code>, a ThreadLocal <code>PageContext</code>
pool will
+      be used. If not specified, the default value of <code>true</code> will
be
+      used.</p>
+    </property>
+
+  </properties>
+
+</section>
+
+
+<section name="Security">
+
+  <properties>
+
+    <property
+    name="org.apache.catalina.connector. CoyoteAdapter.ALLOW_BACKSLASH">
+      <p>If this is <code>true</code> the '\' character will be permitted
as a
+      path delimiter. If not specified, the default value of <code>false</code>
+      will be used.</p>
+    </property>
+
+    <property
+    name="org.apache.tomcat.util.buf. UDecoder.ALLOW_ENCODED_SLASH">
+      <p>If this is <code>true</code> '%2F' and '%5C' will be permitted
as path
+      delimiters. If not specified, the default value of <code>false</code> will
+      be used.</p>
+    </property>
+
+  </properties>
+
+</section>
+
+
+<section name="Specification">
+
+  <properties>
+
+    <property name="org.apache.catalina. STRICT_SERVLET_COMPLIANCE">
+      <p>If this is <code>true</code> the following actions will occur:
+      <ul>
+      <li>any wrapped request or response object passed to an application
+      dispatcher will be checked to ensure that it has wrapped the original
+      request or response. (SRV.8.2 / SRV.14.2.5.1)
+      </li>
+      <li>when updating the access count for the session, the update will be
+      synchronized.
+      </li>
+      </ul>
+      </p>
+    </property>
+
+  </properties>
+
+</section>
+
+
+<section name="Other">
+
+  <properties>
+
+    <property name="catalina.useNaming">
+      <p>If this is <code>false</code> it will override the
+      <code>useNaming</code> attribute for all <a href="context.html">
+      Context</a> elements.</p>
+    </property>
+
+    <property name="jvmRoute">
+      <p>Provides a default value for the <code>jvmRoute</code> attribute
of the
+      <a href="engine.html">Engine</a> element. It does not override the a value
+      configured on the <a href="engine.html">Engine</a> element.</p>
+    </property>
+
+    <property
+    name="org.apache.catalina.loader. WebappClassLoader.ENABLE_CLEAR_REFERENCES">
+      <p>If <code>true</code>, Tomcat attempts to null out any static or
final
+      fields from loaded classes when a web application is stopped as a work
+      around for apparent garbage collection bugs and application coding errors.
+      </p>
+      <p>There have been some issues reported with log4j when this option is
+      <code>true</code>.</p>
+      <p>Applications without memory leaks using recent JVMs should operate
+      correctly with this option set to <code>false</code>.</p>
+      <p>If not specified, the default value of <code>true</code> will
be used.
+      </p>
+    </property>
+
+    <property name="catalina.config">
+      <p>The URL for the catalina.properties configuration file.</p>
+    </property>
+
+    <property name="tomcat.util.buf.StringCache.byte.enabled">
+      <p>If <code>true</code>, the String cache is enabled for
+      <code>ByteChunk</code>. If not specified, the default value of
+      <code>false</code> will be used.</p>
+    </property>
+
+    <property name="tomcat.util.buf.StringCache.char.enabled">
+      <p>If <code>true</code>, the String cache is enabled for
+      <code>CharChunk</code>. If not specified, the default value of
+      <code>false</code> will be used.</p>
+    </property>
+
+    <property name="tomcat.util.buf.StringCache.trainThreshold">
+      <p>The number of times <code>toString()</code> must be called before
the
+      cache is activated. If not specified, the default value of
+      <code>20000</code> will be used.</p>
+    </property>
+
+    <property name="tomcat.util.buf.StringCache.cacheSize">
+      <p>The size of the String cache. If not specified, the default value of
+      <code>200</code> will be used.</p>
+    </property>
+
+    <property name="tomcat.util.buf.StringCache.maxStringSize">
+      <p>The maximum length of String that will be cached. If not specified, the
+      default value of <code>128</code> will be used.</p>
+    </property>
+
+  </properties>
+
+</section>
+
+
+</body>
+</document>

Propchange: tomcat/container/tc5.5.x/webapps/docs/config/systemprops.xml
------------------------------------------------------------------------------
    svn:eol-style = native

Propchange: tomcat/container/tc5.5.x/webapps/docs/config/systemprops.xml
------------------------------------------------------------------------------
    svn:keywords = Author Date Id Revision

Modified: tomcat/container/tc5.5.x/webapps/docs/tomcat-docs.xsl
URL: http://svn.apache.org/viewvc/tomcat/container/tc5.5.x/webapps/docs/tomcat-docs.xsl?rev=675788&r1=675787&r2=675788&view=diff
==============================================================================
--- tomcat/container/tc5.5.x/webapps/docs/tomcat-docs.xsl (original)
+++ tomcat/container/tc5.5.x/webapps/docs/tomcat-docs.xsl Thu Jul 10 15:27:41 2008
@@ -182,7 +182,7 @@
       <xsl:comment>PAGE FOOTER</xsl:comment>
       <tr><td colspan="2">
         <div align="center"><font color="{$body-link}" size="-1"><em>
-        Copyright &#169; 1999-2006, Apache Software Foundation
+        Copyright &#169; 1999-2008, Apache Software Foundation
         </em></font></div>
       </td></tr>
 
@@ -325,6 +325,30 @@
     </table>
   </xsl:template>
 
+  <!-- Process a properties list with nested property elements -->
+  <xsl:template match="properties">
+    <table border="1" cellpadding="5">
+      <tr>
+        <th width="15%" bgcolor="{$attributes-color}">
+          <font color="#ffffff">Property</font>
+        </th>
+        <th width="85%" bgcolor="{$attributes-color}">
+          <font color="#ffffff">Description</font>
+        </th>
+      </tr>
+      <xsl:for-each select="property">
+        <tr>
+          <td align="left" valign="center">
+            <code><xsl:value-of select="@name"/></code>
+          </td>
+          <td align="left" valign="center">
+            <xsl:apply-templates/>
+          </td>
+        </tr>
+      </xsl:for-each>
+    </table>
+  </xsl:template>
+
   <!-- Fix relative links in printer friendly versions of the docs -->
   <xsl:template match="a">
     <xsl:variable name="href" select="@href"/>

Modified: tomcat/current/tc5.5.x/STATUS.txt
URL: http://svn.apache.org/viewvc/tomcat/current/tc5.5.x/STATUS.txt?rev=675788&r1=675787&r2=675788&view=diff
==============================================================================
--- tomcat/current/tc5.5.x/STATUS.txt (original)
+++ tomcat/current/tc5.5.x/STATUS.txt Thu Jul 10 15:27:41 2008
@@ -42,11 +42,6 @@
   +1: markt, fhanik
   -1:
 
-* Add system properties docs
-  http://people.apache.org/~markt/patches/2008-03-10-sys-props.patch
-  +1: markt, fhanik
-  -1:
-
 * Fix docs re use of maxActive
   http://svn.apache.org/viewvc?rev=639842&view=rev
   +1: rjung, markt, fhanik



---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@tomcat.apache.org
For additional commands, e-mail: dev-help@tomcat.apache.org


Mime
View raw message