Author: buildbot
Date: Sun Feb 25 20:19:48 2018
New Revision: 1025956
Log:
Production update by buildbot for tapestry
Modified:
websites/production/tapestry/content/cache/main.pageCache
websites/production/tapestry/content/configuration.html
websites/production/tapestry/content/since-and-deprecated-user-macros.html
Modified: websites/production/tapestry/content/cache/main.pageCache
==============================================================================
Binary files - no diff available.
Modified: websites/production/tapestry/content/configuration.html
==============================================================================
--- websites/production/tapestry/content/configuration.html (original)
+++ websites/production/tapestry/content/configuration.html Sun Feb 25 20:19:48
2018
@@ -162,11 +162,11 @@
<h1 id="Configuration-ConfiguringTapestry">Configuring Tapestry</h1><p>This
page discusses all the ways in which Tapestry can be configured. Tapestry
applications are configured almost entirely using Java, with very little XML at
all.</p><p><strong>Contents</strong></p><p><style type="text/css">/*<![CDATA[*/
-div.rbtoc1519532408001 {padding: 0px;}
-div.rbtoc1519532408001 ul {list-style: disc;margin-left: 0px;}
-div.rbtoc1519532408001 li {margin-left: 0px;padding-left: 0px;}
+div.rbtoc1519589969404 {padding: 0px;}
+div.rbtoc1519589969404 ul {list-style: disc;margin-left: 0px;}
+div.rbtoc1519589969404 li {margin-left: 0px;padding-left: 0px;}
-/*]]>*/</style></p><div class="toc-macro rbtoc1519532408001">
+/*]]>*/</style></p><div class="toc-macro rbtoc1519589969404">
<ul class="toc-indentation"><li><a
href="#Configuration-XMLconfiguration(web.xml)">XML configuration
(web.xml)</a></li><li><a
href="#Configuration-YourApplication'sModuleClass">Your Application's Module
Class</a></li><li><a
href="#Configuration-ConfigurationSymbolNames">Configuration Symbol
Names</a></li><li><a
href="#Configuration-SettingComponentParameterDefaults">Setting Component
Parameter Defaults</a></li><li><a
href="#Configuration-ConfiguringIgnoredPaths">Configuring Ignored
Paths</a></li><li><a
href="#Configuration-ConfiguringContentTypeMapping">Configuring Content Type
Mapping</a></li><li><a href="#Configuration-SettingExecutionModes">Setting
Execution Modes</a></li><li><a
href="#Configuration-SegregatingApplicationsIntoFolders">Segregating
Applications Into Folders</a></li></ul>
</div><h2 id="Configuration-XMLconfiguration(web.xml)">XML configuration
(web.xml)</h2><p>Tapestry runs on top of the standard Java Servlet API. To the
servlet container, such as Tomcat, Tapestry appears as a <em>servlet
filter</em>. This gives Tapestry great flexibility in matching URLs without
requiring lots of XML configuration.</p><p>Although most configuration is done
with Java, a small but necessary amount of configuration occurs inside the
servlet deployment descriptor, WEB-INF/web.xml. Most of the configuration is
boilerplate, nearly the same for all applications.</p><div class="code panel
pdl" style="border-width: 1px;"><div class="codeHeader panelHeader pdl"
style="border-bottom-width: 1px;"><b>web.xml (partial)</b></div><div
class="codeContent panelContent pdl">
<pre class="brush: xml; gutter: false; theme: Default"
style="font-size:12px;"><!DOCTYPE web-app
@@ -232,7 +232,7 @@ div.rbtoc1519532408001 li {margin-left:
</p><div class="aui-message aui-message-warning macro-deprecated"><b
class="param-deprecated">Deprecated since 5.3</b>
- <div class="param-body">The client-side BlackBird console has been
removed.</div>a
+ <div class="param-body">The client-side BlackBird console has been
removed.</div>
</div><h3
id="Configuration-tapestry.bootstrap-root">tapestry.bootstrap-root</h3>
@@ -293,7 +293,7 @@ div.rbtoc1519532408001 li {margin-left:
<div class="aui-message aui-message-warning macro-deprecated"><b
class="param-deprecated">Deprecated since 5.4</b>
- <div class="param-body">Deprecated in 5.4 with no replacement. The
stylesheet is now associated with the core JavaScriptStack</div>a
+ <div class="param-body">Deprecated in 5.4 with no replacement. The
stylesheet is now associated with the core JavaScriptStack</div>
</div><h3
id="Configuration-tapestry.enable-html5-support">tapestry.enable-html5-support</h3><p>
@@ -324,7 +324,7 @@ div.rbtoc1519532408001 li {margin-left:
<div class="aui-message aui-message-warning macro-deprecated"><b
class="param-deprecated">Deprecated since 5.2</b>
- <div class="param-body">Starting in Tapestry 5.2, the optimization to
generate relative URIs has been removed, and all URIs are always absolute.
<em>Removed in 5.3</em>.</div>a
+ <div class="param-body">Starting in Tapestry 5.2, the optimization to
generate relative URIs has been removed, and all URIs are always absolute.
<em>Removed in 5.3</em>.</div>
</div><p><em><strong>SymbolConstants.<span>FORCE_ABSOLUTE_URIS</span></strong> –
For Tapestry 5.0 and 5.1 only</em>: when false (the default), Tapestry will
attempt to optimize URIs that it generates, using relative URIs when such URIs
are shorter than absolute URIs. When true, all URIs will be absolute URIs
(including the context path, and the complete path for the request).</p><h3
id="Configuration-tapestry.gzip-compression-enabled">tapestry.gzip-compression-enabled</h3><p><strong>SymbolConstants.GZIP_COMPRESSION_ENABLED</strong> –
Override to "false" to disable GZIP compression of dynamic Tapestry pages and
static assets.</p><h3
id="Configuration-tapestry.hostname">tapestry.hostname</h3>
@@ -373,35 +373,35 @@ div.rbtoc1519532408001 li {margin-left:
<div class="aui-message aui-message-warning macro-deprecated"><b
class="param-deprecated">Deprecated since 5.2</b>
- <div class="param-body">Starting in 5.2, this is only used if
tapestry.page-pool-enabled is "true". <em>Removed in 5.3</em></div>a
+ <div class="param-body">Starting in 5.2, this is only used if
tapestry.page-pool-enabled is "true". <em>Removed in 5.3</em></div>
</div><p>The time interval that an instantiated page instance may be cached
before being removed. As pages are returned to the pool, they are time stamped.
Periodically (as per the file check interval), the pool is scanned for page
instances that have not been used recently; those that are outside the active
window are discarded. This is used to free up unnecessary page instances after
a request surge. Starting in 5.2, this is only effective if
tapestry.page-pool-enabled is true.</p><p>The default is "10 m" (10 minutes;
see <a class="external-link"
href="http://tapestry.apache.org/current/apidocs/org/apache/tapestry5/ioc/util/TimeInterval.html";>Time
Interval Formats</a>).</p><h3
id="Configuration-tapestry.page-pool-enabled">tapestry.page-pool-enabled</h3><p>Starting
with Tapestry 5.2, page pooling has been turned off by default. This symbol
lets you re-enable page pooling. Under most circumstances this symbol should
not be set. The disabling of page pooling starting in 5.2 signific
antly reduces heap memory usage and improves performance for most web
applications.</p><p>The default is "false".</p>
<div class="aui-message aui-message-warning macro-deprecated"><b
class="param-deprecated">Deprecated since 5.2</b>
- <div class="param-body">Removed in 5.3.</div>a
+ <div class="param-body">Removed in 5.3.</div>
</div><h3
id="Configuration-tapestry.page-pool.hard-limit">tapestry.page-pool.hard-limit</h3>
<div class="aui-message aui-message-warning macro-deprecated"><b
class="param-deprecated">Deprecated since 5.2</b>
- <div class="param-body">Starting in 5.2, this is only used if
tapestry.page-pool-enabled is "true". <em>Removed in 5.3</em></div>a
+ <div class="param-body">Starting in 5.2, this is only used if
tapestry.page-pool-enabled is "true". <em>Removed in 5.3</em></div>
</div><p>The absolute maximum number of page instances (for a particular page
name / locale combination) that Tapestry will create at any time. If this
number is reached, then requests will fail because a page instance is not
available ... this can happen as part of a denial of service attack. For this
value to have any meaning, it should be lower than the number of threads that
the servlet container is configured to use when processing requests.</p><p>The
default is 20 page instances.</p><h3
id="Configuration-tapestry.page-pool.soft-limit">tapestry.page-pool.soft-limit</h3>
<div class="aui-message aui-message-warning macro-deprecated"><b
class="param-deprecated">Deprecated since 5.2</b>
- <div class="param-body">Starting in 5.2, this is only used if
tapestry.page-pool-enabled is "true". <em>Removed in 5.3</em></div>a
+ <div class="param-body">Starting in 5.2, this is only used if
tapestry.page-pool-enabled is "true". <em>Removed in 5.3</em></div>
</div><p>The number of pages in the page pool (for a given page name / locale
combination) before which Tapestry will start to wait for existing pages to be
made available. Under this limit of pages, Tapestry will simply create a new
page instance if no existing instance is readily available. Once the soft limit
is reached, Tapestry will wait a short period of time (the soft wait interval)
to see if an existing page instance is made available. It will then create a
new page instance (unless the hard limit has been reached).</p><p>The default
is 5 page instances. Remember that page pooling is done separately for each
page (and localization of the page).</p><h3
id="Configuration-tapestry.page-pool.soft-wait">tapestry.page-pool.soft-wait</h3>
<div class="aui-message aui-message-warning macro-deprecated"><b
class="param-deprecated">Deprecated since 5.2</b>
- <div class="param-body">Starting in 5.2, this is only used if
tapestry.page-pool-enabled is "true". <em>Removed in 5.3</em></div>a
+ <div class="param-body">Starting in 5.2, this is only used if
tapestry.page-pool-enabled is "true". <em>Removed in 5.3</em></div>
</div><p>The time interval that Tapestry will wait for a page instance to
become available before deciding whether to create an entirely new page
instance.</p><p>The default is "10 ms" (10 milliseconds; see <a
class="external-link"
href="http://tapestry.apache.org/current/apidocs/org/apache/tapestry5/ioc/util/TimeInterval.html";>Time
Interval Formats</a>).</p><h3
id="Configuration-tapestry.page-preload-mode">tapestry.page-preload-mode</h3><p>
@@ -423,7 +423,7 @@ div.rbtoc1519532408001 li {margin-left:
</div><p>If true (the default), then Tapestry IoC will attempt to reload
service implementations when they change. This only applies to classes that
Tapestry IoC instantiates itself, and have a known service interface (the
container creates a proxy that, internally, can reload the implementation).
Service reloading only works when the underlying class files are on the
filesystem ... it is intended for development, not as an option in
production.</p><p>This must be specified as a JVM system property. <em>You may
not set it in your module class.</em></p><h3
id="Configuration-tapestry.scriptaculous">tapestry.scriptaculous</h3>
-<div class="aui-message aui-message-info macro-since"><b
class="param-since">Added in $paramsince</b>
+<div class="aui-message aui-message-info macro-since"><b
class="param-since">Added in 5.2</b>
@@ -438,7 +438,7 @@ div.rbtoc1519532408001 li {margin-left:
<div class="aui-message aui-message-warning macro-deprecated"><b
class="param-deprecated">Deprecated since 5.2</b>
- <div class="param-body"><em>Removed in 5.3</em></div>a
+ <div class="param-body"><em>Removed in 5.3</em></div>
</div><p><strong>SymbolConstants.SUPPRESS_REDIRECT_FROM_ACTION_REQUESTS</strong> –
Normally, Tapestry responds to action requests (such as form submissions) by
sending a client-side redirect to the rendering page. This has a lot of
benefits in terms of improving browser navigation, making sure URLs are
bookmarkable, and so forth. However, it has a cost: more data stored
persistently in the session, and a double-request for each user action (one
action request, one render request).</p><p>Setting this symbol to "true"
changes the Tapestry behavior to make it more like Tapestry 4: a markup
response is sent directly for the action request, with no redirect in the
middle. This option should be used with care, and only in cases where you are
certain that the benefits outweigh the disadvantages.</p><h3
id="Configuration-tapestry.thread-pool.core-pool-size">tapestry.thread-pool.core-pool-size</h3><p><strong>IOCSymbols.THREAD_POOL_CORE_SIZE</strong> –
Nominal size of th
e thread pool Tapestry uses to execute tasks in parallel. Under sufficient
load, the thread pool may grow larger than this core size. Defaults to
3.</p><h3
id="Configuration-tapestry.thread-pool.max-pool-size">tapestry.thread-pool.max-pool-size</h3><p><strong>IOCSymbols.THREAD_POOL_MAX_SIZE</strong> –
Maximum size of the thread pool Tapestry uses to execute tasks in parallel.
Defaults to 10.</p><h3
id="Configuration-tapestry.thread-pool.queue-size">tapestry.thread-pool.queue-size</h3>
Modified:
websites/production/tapestry/content/since-and-deprecated-user-macros.html
==============================================================================
--- websites/production/tapestry/content/since-and-deprecated-user-macros.html
(original)
+++ websites/production/tapestry/content/since-and-deprecated-user-macros.html
Sun Feb 25 20:19:48 2018
@@ -56,6 +56,21 @@
<div class="title" style="float:left; margin: 0 0 0 3em"><h1
id="SmallBanner-PageTitle">Since and Deprecated User Macros</h1></div>
</div>
+ <div id="smallbanner"><div class="searchbox"
style="float:right;margin: .3em 1em .1em 1em"><span style="color: #999;
font-size: 90%">Tapestry docs, issues, wikis & blogs:</span>
+<form enctype="application/x-www-form-urlencoded" method="get"
action="https://tapestry.apache.org/search.html";>
+ <input type="text" name="q">
+ <input type="submit" value="Search">
+</form>
+
+</div>
+
+
+<div class="emblem" style="float:left"><p><span
class="confluence-embedded-file-wrapper"><img class="confluence-embedded-image
confluence-external-resource"
src="https://tapestry.apache.org/images/tapestry_small.png";
data-image-src="https://tapestry.apache.org/images/tapestry_small.png";></span></p></div>
+
+
+<div class="title" style="float:left; margin: 0 0 0 3em"><h1
id="SmallBanner-PageTitle">Page Title</h1></div>
+
+</div>
<div class="clearer"></div>
</div>
@@ -67,54 +82,63 @@
</div>
<div id="content">
- <div id="ConfluenceContent"><p>We have two Confluence user
macros to mark deprecated or newly added features in the documentation wiki:
{<code>since</code>} and {<code>deprecated</code>}. Both aren't optimal (we can
still style them if we see the need) and don't work within tables or similar
structures (or maybe the versions without any parameters do, we haven't tried).
See also the <a
href="https://cwiki.apache.org/confluence/display/INFRA/ASF+Confluence+User+Macros";>list
of user macros</a>.</p><h2 id="SinceandDeprecatedUserMacros-Thesincemacro">The
since macro</h2><p>Examples:</p><div class="table-wrap"><table
class="confluenceTable"><tbody><tr><td colspan="1" rowspan="1"
class="confluenceTd"><div class="preformatted panel" style="border-width:
1px;"><div class="preformattedContent panelContent">
-<pre>{since}This got added in 5.2{since}</pre>
-</div></div></td><td colspan="1" rowspan="1" class="confluenceTd"><p>
+ <div id="ConfluenceContent"><p>We have two Confluence user
macros to mark deprecated or newly added features in the documentation wiki:
{<code>since</code>} and {<code>deprecated</code>}. See also the <a
href="https://cwiki.apache.org/confluence/display/INFRA/ASF+Confluence+User+Macros";>list
of user macros</a>.</p><h2 id="SinceandDeprecatedUserMacros-Thesincemacro">The
since macro</h2><p>Examples:
+</p><div class="aui-message aui-message-info macro-since"><b
class="param-since">Added in 5.2</b>
-</p><div class="aui-message aui-message-info">
-This got added in 5.2
-</div></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><div
class="preformatted panel" style="border-width: 1px;"><div
class="preformattedContent panelContent">
-<pre>{since:since=5.2}This got added in 5.2{since} And this was always
there.</pre>
-</div></div></td><td colspan="1" rowspan="1" class="confluenceTd"><p>
+</div>
-</p><div class="aui-message aui-message-info">
-Added in 5.2
- This got added in 5.2
-</div>And this was always there.</td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><div class="preformatted panel" style="border-width:
1px;"><div class="preformattedContent panelContent">
-<pre>{since:since=5.2}{since}</pre>
-</div></div></td><td colspan="1" rowspan="1" class="confluenceTd"><p>
+<div class="aui-message aui-message-info macro-since"><b
class="param-since">Added in 5.2</b>
+ <span class="param-message">— Some short message</span>
+
+
+</div>
+
+<div class="aui-message aui-message-info macro-since"><b
class="param-since">Added in 5.2</b>
+
+
+ <div class="param-body"> This is a longer message about the new
feature. It can contain <em>wiki markup and
<strong>formatting.</strong></em></div>
+
+</div>
+<div class="aui-message aui-message-info macro-since"><b
class="param-since">Added in 5.2</b>
-</p><div class="aui-message aui-message-info">
-Added in 5.2
-  
-</div></td></tr></tbody></table></div><h2
id="SinceandDeprecatedUserMacros-Thedeprecatedmacro">The deprecated
macro</h2><p>Examples:</p><div class="table-wrap"><table
class="confluenceTable"><tbody><tr><td colspan="1" rowspan="1"
class="confluenceTd"><div class="preformatted panel" style="border-width:
1px;"><div class="preformattedContent panelContent">
-<pre>{deprecated}This was removed in 5.2{deprecated}</pre>
-</div></div></td><td colspan="1" rowspan="1" class="confluenceTd"><p>
+ <span class="param-message">— Some short message</span>
-</p><div class="aui-message aui-message-warning">
-This was removed in 5.2
-</div></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><div
class="preformatted panel" style="border-width: 1px;"><div
class="preformattedContent panelContent">
-<pre>{deprecated:since=5.2}This was removed in 5.2{deprecated} And this is
still there.</pre>
-</div></div></td><td colspan="1" rowspan="1" class="confluenceTd"><p>
+ <div class="param-body"> This is a longer message about the new
feature. It can contain <em>wiki markup and
<strong>formatting.</strong></em></div>
+
+</div><h2 id="SinceandDeprecatedUserMacros-Thedeprecatedmacro">The deprecated
macro</h2><p>Examples:</p><p> 
+
+</p><div class="aui-message aui-message-warning macro-deprecated"><b
class="param-deprecated">Deprecated since 5.2</b>
+
+
+
+</div>
+
+<div class="aui-message aui-message-warning macro-deprecated"><b
class="param-deprecated">Deprecated since 5.2</b>
+
+ <span class="param-message">— Some short message</span>
+
+
+</div>
+
+<div class="aui-message aui-message-warning macro-deprecated"><b
class="param-deprecated">Deprecated since 5.2</b>
+
+
+ <div class="param-body"> This is a longer message about the new
feature. It can contain <em>wiki markup and
<strong>formatting.</strong></em></div>
+
+</div>
+<div class="aui-message aui-message-warning macro-deprecated"><b
class="param-deprecated">Deprecated since 5.2</b>
-</p><div class="aui-message aui-message-warning">
-Deprecated since 5.2 |
-This was removed in 5.2
-</div>And this is still there.</td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><div class="preformatted panel" style="border-width:
1px;"><div class="preformattedContent panelContent">
-<pre>{deprecated:since=5.2}{deprecated}</pre>
-</div></div></td><td colspan="1" rowspan="1" class="confluenceTd"><p>
+ <span class="param-message">— Some short message</span>
+ <div class="param-body">  This is a longer message about the new
feature. It can contain <em>wiki markup and
<strong>formatting.</strong></em></div>
-</p><div class="aui-message aui-message-warning">
-Deprecated since 5.2 |
- 
-</div></td></tr></tbody></table></div></div>
+</div></div>
</div>
<div class="clearer"></div>
![https://tapestry.apache.org/images/tapestry_small.png"](https://tapestry.apache.org/images/tapestry_small.png"){kind=link}