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 © 1999-2006, Apache Software Foundation + Copyright © 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: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]