Author: markt
Date: Mon Jun 15 09:55:44 2009
New Revision: 784708
URL: http://svn.apache.org/viewvc?rev=784708&view=rev
Log:
Add system props to documentation.
Added:
tomcat/container/branches/tc4.1.x/webapps/tomcat-docs/config/systemprops.xml
(with props)
Modified:
tomcat/container/branches/tc4.1.x/webapps/tomcat-docs/config/project.xml
tomcat/container/branches/tc4.1.x/webapps/tomcat-docs/tomcat-docs.xsl
Modified:
tomcat/container/branches/tc4.1.x/webapps/tomcat-docs/config/project.xml
URL:
http://svn.apache.org/viewvc/tomcat/container/branches/tc4.1.x/webapps/tomcat-docs/config/project.xml?rev=784708&r1=784707&r2=784708&view=diff
==============================================================================
--- tomcat/container/branches/tc4.1.x/webapps/tomcat-docs/config/project.xml
(original)
+++ tomcat/container/branches/tc4.1.x/webapps/tomcat-docs/config/project.xml
Mon Jun 15 09:55:44 2009
@@ -72,6 +72,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/branches/tc4.1.x/webapps/tomcat-docs/config/systemprops.xml
URL:
http://svn.apache.org/viewvc/tomcat/container/branches/tc4.1.x/webapps/tomcat-docs/config/systemprops.xml?rev=784708&view=auto
==============================================================================
---
tomcat/container/branches/tc4.1.x/webapps/tomcat-docs/config/systemprops.xml
(added)
+++
tomcat/container/branches/tc4.1.x/webapps/tomcat-docs/config/systemprops.xml
Mon Jun 15 09:55:44 2009
@@ -0,0 +1,149 @@
+<?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="Security">
+
+ <properties>
+
+ <property
+ name="org.apache.coyote.tomcat4. 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>
+
+ <property
+ name="org.apache.coyote. USE_CUSTOM_STATUS_MSG_IN_HEADER"><p>If this is
+ <code>true</code> custom HTTP status messages will be used within HTTP
+ headers. Users must ensure that any such message is ISO-8859-1 encoded,
+ particularly if user provided input is included in the message, to
prevent
+ a possible XSS vulnerability. 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> cookies will be parsed strictly and v0
+ cookies will not work with any invalid characters.
+ <br/>If set to false, any v0 cookie with invalid characters will be
+ switched to a v1 cookie and the value will be quoted. If not specified,
+ the default value of <code>false</code> will be used.
+ </li>
+ </ul>
+ </p>
+ </property>
+
+ <property
+ name="org.apache.tomcat.util.http. ServerCookie.ALWAYS_ADD_EXPIRES">
+ <p>If this is <code>true</code> Tomcat will always add an expires
+ parameter to a SetCookie header even for cookies with version greater
than
+ zero. This is to work around a known IE6 and IE7 bug that causes IE to
+ ignore the Max-Age parameter in a SetCookie header.If not specified, the
+ default value of <code>true</code> will be used.</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="catalina.config">
+ <p>The URL for the catalina.properties configuration file.</p>
+ </property>
+
+ <property name="loader.config">
+ <p>The URL for the loader.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/branches/tc4.1.x/webapps/tomcat-docs/config/systemprops.xml
------------------------------------------------------------------------------
svn:eol-style = native
Propchange:
tomcat/container/branches/tc4.1.x/webapps/tomcat-docs/config/systemprops.xml
------------------------------------------------------------------------------
svn:keywords = Date Author Id Revision
Modified: tomcat/container/branches/tc4.1.x/webapps/tomcat-docs/tomcat-docs.xsl
URL:
http://svn.apache.org/viewvc/tomcat/container/branches/tc4.1.x/webapps/tomcat-docs/tomcat-docs.xsl?rev=784708&r1=784707&r2=784708&view=diff
==============================================================================
--- tomcat/container/branches/tc4.1.x/webapps/tomcat-docs/tomcat-docs.xsl
(original)
+++ tomcat/container/branches/tc4.1.x/webapps/tomcat-docs/tomcat-docs.xsl Mon
Jun 15 09:55:44 2009
@@ -179,7 +179,7 @@
<xsl:comment>PAGE FOOTER</xsl:comment>
<tr><td colspan="2">
<div align="center"><font color="{$body-link}" size="-1"><em>
- Copyright © 1999-2005, Apache Software Foundation
+ Copyright © 1999-2009, Apache Software Foundation
</em></font></div>
</td></tr>
@@ -322,6 +322,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"/>
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscr...@tomcat.apache.org
For additional commands, e-mail: dev-h...@tomcat.apache.org
