You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@tapestry.apache.org by bo...@apache.org on 2013/02/24 15:18:33 UTC

git commit: A few JavaDoc spelling fixes (no code changes here)

Updated Branches:
  refs/heads/master 69a6c3ead -> 969b9b1ae


A few JavaDoc spelling fixes (no code changes here)

Project: http://git-wip-us.apache.org/repos/asf/tapestry-5/repo
Commit: http://git-wip-us.apache.org/repos/asf/tapestry-5/commit/969b9b1a
Tree: http://git-wip-us.apache.org/repos/asf/tapestry-5/tree/969b9b1a
Diff: http://git-wip-us.apache.org/repos/asf/tapestry-5/diff/969b9b1a

Branch: refs/heads/master
Commit: 969b9b1aeab570158cc5ba11c4c4f0fba13bee2a
Parents: 69a6c3e
Author: Bob Harner <bo...@apache.org>
Authored: Sun Feb 24 09:18:21 2013 -0500
Committer: Bob Harner <bo...@apache.org>
Committed: Sun Feb 24 09:18:21 2013 -0500

----------------------------------------------------------------------
 .../main/java/org/apache/tapestry5/Binding.java    |    4 +-
 .../src/main/java/org/apache/tapestry5/Block.java  |    4 +-
 .../org/apache/tapestry5/ComponentResources.java   |    6 ++--
 .../apache/tapestry5/ComponentResourcesCommon.java |   10 +++---
 .../java/org/apache/tapestry5/ContentType.java     |    6 ++--
 .../java/org/apache/tapestry5/CookieBuilder.java   |   14 ++++++++
 .../src/main/java/org/apache/tapestry5/Field.java  |    4 +-
 .../apache/tapestry5/FormValidationControl.java    |    8 ++--
 .../src/main/java/org/apache/tapestry5/Link.java   |    6 ++--
 .../org/apache/tapestry5/MarkupWriterListener.java |    4 +-
 .../org/apache/tapestry5/PersistenceConstants.java |    4 +-
 .../java/org/apache/tapestry5/RadioContainer.java  |    6 ++--
 .../org/apache/tapestry5/SelectModelVisitor.java   |    4 +-
 .../java/org/apache/tapestry5/SymbolConstants.java |   24 ++++++++------
 .../java/org/apache/tapestry5/TapestryFilter.java  |   10 +++---
 .../java/org/apache/tapestry5/TapestryMarkers.java |    4 +-
 .../java/org/apache/tapestry5/ValueEncoder.java    |    2 +-
 17 files changed, 69 insertions(+), 51 deletions(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/969b9b1a/tapestry-core/src/main/java/org/apache/tapestry5/Binding.java
----------------------------------------------------------------------
diff --git a/tapestry-core/src/main/java/org/apache/tapestry5/Binding.java b/tapestry-core/src/main/java/org/apache/tapestry5/Binding.java
index 31e3818..8a99914 100644
--- a/tapestry-core/src/main/java/org/apache/tapestry5/Binding.java
+++ b/tapestry-core/src/main/java/org/apache/tapestry5/Binding.java
@@ -1,4 +1,4 @@
-// Copyright 2006, 2007 The Apache Software Foundation
+// Copyright 2006-2013 The Apache Software Foundation
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -20,7 +20,7 @@ import org.apache.tapestry5.ioc.AnnotationProvider;
  * A binding is a connection between a component and its container (another component), that allows the embedded
  * component to gain access to <em>resources</em> defined by the container. Resources can represent any kind of value
  * that can be obtained from the parent component, but is often a JavaBean property that can be read and updated.
- * Different implementations of Binding as used to access different kinds of resources of the container.
+ * Different implementations of Binding are used to access different kinds of resources of the container.
  * <p/>
  * A binding ultimately must provide access to the underlying annotations. In most cases, there are no annotations, but
  * bindings that ultimate invoke methods or read and update fields must provide access to those annotations.

http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/969b9b1a/tapestry-core/src/main/java/org/apache/tapestry5/Block.java
----------------------------------------------------------------------
diff --git a/tapestry-core/src/main/java/org/apache/tapestry5/Block.java b/tapestry-core/src/main/java/org/apache/tapestry5/Block.java
index 27db96f..95e658e 100644
--- a/tapestry-core/src/main/java/org/apache/tapestry5/Block.java
+++ b/tapestry-core/src/main/java/org/apache/tapestry5/Block.java
@@ -1,4 +1,4 @@
-// Copyright 2007, 2008 The Apache Software Foundation
+// Copyright 2007-2013 The Apache Software Foundation
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -19,7 +19,7 @@ package org.apache.tapestry5;
  * template, a block is demarcated using the &lt;t:block&gt; or &lt;t:parameter&gt; elements. The interface defines no
  * methods, but the provided implementations of Block are capable of rendering their contents on demand.
  * <p/>
- * Tapestry includes coecions from String to {@link org.apache.tapestry5.Renderable} and {@link
+ * Tapestry includes coercions from String to {@link org.apache.tapestry5.Renderable} and {@link
  * org.apache.tapestry5.Renderable} to Block. This means that components that take Block parameters may be bound to
  * literal strings, to arbitrary numbers (or other objects, with the expectation that they will be converted to
  * strings), or to renderable objects such as components.

http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/969b9b1a/tapestry-core/src/main/java/org/apache/tapestry5/ComponentResources.java
----------------------------------------------------------------------
diff --git a/tapestry-core/src/main/java/org/apache/tapestry5/ComponentResources.java b/tapestry-core/src/main/java/org/apache/tapestry5/ComponentResources.java
index fcc1c7c..137c43d 100644
--- a/tapestry-core/src/main/java/org/apache/tapestry5/ComponentResources.java
+++ b/tapestry-core/src/main/java/org/apache/tapestry5/ComponentResources.java
@@ -1,4 +1,4 @@
-// Copyright 2006, 2007, 2008, 2012 The Apache Software Foundation
+// Copyright 2006-2013 The Apache Software Foundation
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -52,7 +52,7 @@ public interface ComponentResources extends ComponentResourcesCommon
 
     /**
      * Returns the component which contains this component, or null for the root component. For mixins, this returns the
-     * componet to which the mixin is attached.
+     * component to which the mixin is attached.
      */
     Component getContainer();
 
@@ -216,7 +216,7 @@ public interface ComponentResources extends ComponentResourcesCommon
     List<String> getInformalParameterNames();
 
     /**
-     * Reads an informal parameter and {@linkplain org.apache.tapestry5.ioc.services.TypeCoercer coercers} the bound
+     * Reads an informal parameter and {@linkplain org.apache.tapestry5.ioc.services.TypeCoercer coerces} the bound
      * value to the indicated type.
      *
      * @param name

http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/969b9b1a/tapestry-core/src/main/java/org/apache/tapestry5/ComponentResourcesCommon.java
----------------------------------------------------------------------
diff --git a/tapestry-core/src/main/java/org/apache/tapestry5/ComponentResourcesCommon.java b/tapestry-core/src/main/java/org/apache/tapestry5/ComponentResourcesCommon.java
index 2f2c742..c15e254 100644
--- a/tapestry-core/src/main/java/org/apache/tapestry5/ComponentResourcesCommon.java
+++ b/tapestry-core/src/main/java/org/apache/tapestry5/ComponentResourcesCommon.java
@@ -1,4 +1,4 @@
-// Copyright 2006, 2007, 2008, 2009, 2011 The Apache Software Foundation
+// Copyright 2006-2013 The Apache Software Foundation
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -35,7 +35,7 @@ public interface ComponentResourcesCommon extends Locatable
     String getId();
 
     /**
-     * Return a string consisting the concatinated ids of all containing components, separated by periods. In addition,
+     * Return a string consisting the concatenated ids of all containing components, separated by periods. In addition,
      * nested ids are always all lower case. I.e., "foo.bar.baz". Returns null for the root component of a page.
      */
     String getNestedId();
@@ -51,7 +51,7 @@ public interface ComponentResourcesCommon extends Locatable
     String getCompleteId();
 
     /**
-     * A convienience for invoking {@link #triggerContextEvent(String, EventContext , ComponentEventCallback)}. Wraps
+     * A convenience method for invoking {@link #triggerContextEvent(String, EventContext , ComponentEventCallback)}. Wraps
      * the context values into an {@link org.apache.tapestry5.EventContext}.
      * 
      * @param eventType
@@ -241,7 +241,7 @@ public interface ComponentResourcesCommon extends Locatable
      * @param context
      *            the activation context for the page. If omitted, the activation context is obtained from the
      *            target page
-     * @return link for a render request to the targetted page
+     * @return link for a render request to the targeted page
      * @deprecated Use {@link org.apache.tapestry5.services.PageRenderLinkSource#createPageRenderLink(String)} or
      *             {@link org.apache.tapestry5.services.PageRenderLinkSource#createPageRenderLinkWithContext(String, Object[])}
      *             instead
@@ -260,7 +260,7 @@ public interface ComponentResourcesCommon extends Locatable
      * @param context
      *            the activation context for the page. If omitted, the activation context is obtained from the
      *            target page
-     * @return link for a render request to the targetted page
+     * @return link for a render request to the targeted page
      * @deprecated Use {@link org.apache.tapestry5.services.PageRenderLinkSource#createPageRenderLink(Class)} or
      *             {@link org.apache.tapestry5.services.PageRenderLinkSource#createPageRenderLinkWithContext(Class, Object[])}
      *             instead

http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/969b9b1a/tapestry-core/src/main/java/org/apache/tapestry5/ContentType.java
----------------------------------------------------------------------
diff --git a/tapestry-core/src/main/java/org/apache/tapestry5/ContentType.java b/tapestry-core/src/main/java/org/apache/tapestry5/ContentType.java
index 7805d86..87f0a1b 100644
--- a/tapestry-core/src/main/java/org/apache/tapestry5/ContentType.java
+++ b/tapestry-core/src/main/java/org/apache/tapestry5/ContentType.java
@@ -1,4 +1,4 @@
-// Copyright 2007, 2008, 2010 The Apache Software Foundation
+// Copyright 2007-2013 The Apache Software Foundation
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -23,7 +23,7 @@ import org.apache.tapestry5.ioc.internal.util.CollectionFactory;
 import org.apache.tapestry5.ioc.internal.util.InternalUtils;
 
 /**
- * Represents an HTTP content type. Allows to set various elements like the mime type, the character set, and other
+ * Represents an HTTP content type. Allows to set various elements like the MIME type, the character set, and other
  * parameters. This is similar to a number of other implementations of the same concept in JAF, etc. We have created
  * this simple implementation to avoid including the whole libraries.
  */
@@ -64,7 +64,7 @@ public final class ContentType
 
 
     /**
-     * Returns true only if the other object is another instance of ContentType, and has the ssame baseType, subType and
+     * Returns true only if the other object is another instance of ContentType, and has the same baseType, subType and
      * set of parameters.
      */
     @Override

http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/969b9b1a/tapestry-core/src/main/java/org/apache/tapestry5/CookieBuilder.java
----------------------------------------------------------------------
diff --git a/tapestry-core/src/main/java/org/apache/tapestry5/CookieBuilder.java b/tapestry-core/src/main/java/org/apache/tapestry5/CookieBuilder.java
index ea62fc8..9068d6a 100644
--- a/tapestry-core/src/main/java/org/apache/tapestry5/CookieBuilder.java
+++ b/tapestry-core/src/main/java/org/apache/tapestry5/CookieBuilder.java
@@ -1,3 +1,17 @@
+// Copyright 2012-2013 The Apache Software Foundation
+//
+// Licensed 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.
+
 package org.apache.tapestry5;
 
 import org.apache.tapestry5.services.Request;

http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/969b9b1a/tapestry-core/src/main/java/org/apache/tapestry5/Field.java
----------------------------------------------------------------------
diff --git a/tapestry-core/src/main/java/org/apache/tapestry5/Field.java b/tapestry-core/src/main/java/org/apache/tapestry5/Field.java
index 7ee38b7..eabc532 100644
--- a/tapestry-core/src/main/java/org/apache/tapestry5/Field.java
+++ b/tapestry-core/src/main/java/org/apache/tapestry5/Field.java
@@ -1,4 +1,4 @@
-// Copyright 2006, 2007, 2008 The Apache Software Foundation
+// Copyright 2013 The Apache Software Foundation
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -21,7 +21,7 @@ package org.apache.tapestry5;
  * Timing is important, as components may render multiple times, due to looping and other factors. Generally, a
  * component's {@link #getControlName()} will only be accurate after it has rendered.  In some cases, when generating
  * JavaScript for example, it is necessary to {@linkplain org.apache.tapestry5.services.Heartbeat#defer(Runnable) wait
- * until the end of the current Heartbeat} to ensure that all components have had thier chance to render.
+ * until the end of the current Heartbeat} to ensure that all components have had their chance to render.
  */
 public interface Field extends ClientElement
 {

http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/969b9b1a/tapestry-core/src/main/java/org/apache/tapestry5/FormValidationControl.java
----------------------------------------------------------------------
diff --git a/tapestry-core/src/main/java/org/apache/tapestry5/FormValidationControl.java b/tapestry-core/src/main/java/org/apache/tapestry5/FormValidationControl.java
index 415dbc1..f47dd92 100644
--- a/tapestry-core/src/main/java/org/apache/tapestry5/FormValidationControl.java
+++ b/tapestry-core/src/main/java/org/apache/tapestry5/FormValidationControl.java
@@ -1,4 +1,4 @@
-// Copyright 2007, 2008 The Apache Software Foundation
+// Copyright 2007-2013 The Apache Software Foundation
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -15,17 +15,17 @@
 package org.apache.tapestry5;
 
 /**
- * Allows control over validation concerns of a Form component.
+ * Allows control over the validation concerns of a Form component.
  */
 public interface FormValidationControl
 {
     /**
-     * A convienience for invoking {@link org.apache.tapestry5.ValidationTracker#recordError(String)}.
+     * A convenience method for invoking {@link org.apache.tapestry5.ValidationTracker#recordError(String)}.
      */
     void recordError(String errorMessage);
 
     /**
-     * A convienience for invoking {@link org.apache.tapestry5.ValidationTracker#recordError(Field, String)}.
+     * A convenience method for invoking {@link org.apache.tapestry5.ValidationTracker#recordError(Field, String)}.
      */
     void recordError(Field field, String errorMessage);
 

http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/969b9b1a/tapestry-core/src/main/java/org/apache/tapestry5/Link.java
----------------------------------------------------------------------
diff --git a/tapestry-core/src/main/java/org/apache/tapestry5/Link.java b/tapestry-core/src/main/java/org/apache/tapestry5/Link.java
index e08dde0..437229c 100644
--- a/tapestry-core/src/main/java/org/apache/tapestry5/Link.java
+++ b/tapestry-core/src/main/java/org/apache/tapestry5/Link.java
@@ -1,4 +1,4 @@
-// Copyright 2006, 2007, 2008, 2010, 2011 The Apache Software Foundation
+// Copyright 2006-2013 The Apache Software Foundation
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -122,7 +122,7 @@ public interface Link
     /**
      * Returns the absolute URL, which includes the scheme, hostname and possibly port (as per
      * {@link BaseURLSource#getBaseURL(boolean)}).
-     * By default, the scheme is chosen to match the current {@linkplain Request#isSecure() requests security}.
+     * By default, the scheme is chosen to match the {@linkplain Request#isSecure() security} of the current request.
      * <p/>
      * Note: the semantics of this method changed between Tapestry 5.1 and 5.2. Most code should use toString() or
      * {@link #toURI()} (which are equivalent) instead.
@@ -150,7 +150,7 @@ public interface Link
     void setSecurity(LinkSecurity newSecurity);
 
     /**
-     * Returns the current security for this link, which reflects whether the targetted page is itself secure or insecure.
+     * Returns the current security for this link, which reflects whether the targeted page is itself secure or insecure.
      *
      * @since 5.3
      */

http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/969b9b1a/tapestry-core/src/main/java/org/apache/tapestry5/MarkupWriterListener.java
----------------------------------------------------------------------
diff --git a/tapestry-core/src/main/java/org/apache/tapestry5/MarkupWriterListener.java b/tapestry-core/src/main/java/org/apache/tapestry5/MarkupWriterListener.java
index 7984ec2..4d2617a 100644
--- a/tapestry-core/src/main/java/org/apache/tapestry5/MarkupWriterListener.java
+++ b/tapestry-core/src/main/java/org/apache/tapestry5/MarkupWriterListener.java
@@ -1,4 +1,4 @@
-// Copyright 2008 The Apache Software Foundation
+// Copyright 2008-2013 The Apache Software Foundation
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -18,7 +18,7 @@ import org.apache.tapestry5.dom.Element;
 
 
 /**
- * An interface that allows objects to be alerted when after an element is started, and after an element is ended.
+ * An interface that allows objects to be alerted after an element is started, and after an element is ended.
  */
 public interface MarkupWriterListener
 {

http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/969b9b1a/tapestry-core/src/main/java/org/apache/tapestry5/PersistenceConstants.java
----------------------------------------------------------------------
diff --git a/tapestry-core/src/main/java/org/apache/tapestry5/PersistenceConstants.java b/tapestry-core/src/main/java/org/apache/tapestry5/PersistenceConstants.java
index 8fc71d9..c722bd2 100644
--- a/tapestry-core/src/main/java/org/apache/tapestry5/PersistenceConstants.java
+++ b/tapestry-core/src/main/java/org/apache/tapestry5/PersistenceConstants.java
@@ -1,4 +1,4 @@
-// Copyright 2008, 2010 The Apache Software Foundation
+// Copyright 2008-2013 The Apache Software Foundation
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -32,7 +32,7 @@ public class PersistenceConstants
     public static final String CLIENT = "client";
 
     /**
-     * A that stores data in the session, but only until the next request. This is often
+     * The field's value is stored in the session, but only until the next request. This is often
      * used for confirmation messages presented to the user.
      */
     public static final String FLASH = "flash";

http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/969b9b1a/tapestry-core/src/main/java/org/apache/tapestry5/RadioContainer.java
----------------------------------------------------------------------
diff --git a/tapestry-core/src/main/java/org/apache/tapestry5/RadioContainer.java b/tapestry-core/src/main/java/org/apache/tapestry5/RadioContainer.java
index 0b37fa7..b5f121d 100644
--- a/tapestry-core/src/main/java/org/apache/tapestry5/RadioContainer.java
+++ b/tapestry-core/src/main/java/org/apache/tapestry5/RadioContainer.java
@@ -1,4 +1,4 @@
-// Copyright 2007, 2008 The Apache Software Foundation
+// Copyright 2007-2013 The Apache Software Foundation
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -18,7 +18,7 @@ import org.apache.tapestry5.corelib.components.Radio;
 
 /**
  * A container of {@link Radio} components, used to identify the element name used when rendering the individual radio
- * buttons (all buttons in a group share the same element name) and to
+ * buttons. (All buttons in a group share the same element name.)
  */
 public interface RadioContainer
 {
@@ -31,7 +31,7 @@ public interface RadioContainer
     String getControlName();
 
     /**
-     * If true, then all buttons within the container should also be disabled.
+     * If true, then all radio buttons within the container should be disabled.
      */
     boolean isDisabled();
 

http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/969b9b1a/tapestry-core/src/main/java/org/apache/tapestry5/SelectModelVisitor.java
----------------------------------------------------------------------
diff --git a/tapestry-core/src/main/java/org/apache/tapestry5/SelectModelVisitor.java b/tapestry-core/src/main/java/org/apache/tapestry5/SelectModelVisitor.java
index efcb60d..34d514c 100644
--- a/tapestry-core/src/main/java/org/apache/tapestry5/SelectModelVisitor.java
+++ b/tapestry-core/src/main/java/org/apache/tapestry5/SelectModelVisitor.java
@@ -1,4 +1,4 @@
-// Copyright 2007 The Apache Software Foundation
+// Copyright 2007-2013 The Apache Software Foundation
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -15,7 +15,7 @@
 package org.apache.tapestry5;
 
 /**
- * Callback interface that allows for visiting the option groups and option models of a select model in correct render
+ * Callback interface that allows for visiting the option groups and option models of a select model in correct order
  * order.
  */
 public interface SelectModelVisitor

http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/969b9b1a/tapestry-core/src/main/java/org/apache/tapestry5/SymbolConstants.java
----------------------------------------------------------------------
diff --git a/tapestry-core/src/main/java/org/apache/tapestry5/SymbolConstants.java b/tapestry-core/src/main/java/org/apache/tapestry5/SymbolConstants.java
index 44f4ae8..28b84d4 100644
--- a/tapestry-core/src/main/java/org/apache/tapestry5/SymbolConstants.java
+++ b/tapestry-core/src/main/java/org/apache/tapestry5/SymbolConstants.java
@@ -34,8 +34,11 @@ public class SymbolConstants
      */
     public static final String EXECUTION_MODE = "tapestry.execution-mode";
     /**
-     * Indicates whether Tapestry is running in production mode or developer mode. The primary difference is how
-     * exceptions are reported.
+     * Indicates whether Tapestry is running in production mode or developer mode. This affects a large
+     * number of Tapestry behaviors related to performance and security, including how exceptions are
+     * reported, whether far-future expire headers are emitted, whether JavaScript files may be combined,
+     * whether JSON is compressed, whether component field & parameter values are shadowed to instance
+     * variables (to assist with debugging), and more.  
      */
     public static final String PRODUCTION_MODE = "tapestry.production-mode";
 
@@ -57,20 +60,21 @@ public class SymbolConstants
 
     /**
      * Controls whether whitespace is compressed by default in templates, or left as is. The factory default is to
-     * compress whitespace. This can be overridden using the xml:space attribute inside template elements.
+     * compress whitespace. (This can also be overridden using the xml:space attribute inside template elements.)
      */
     public static final String COMPRESS_WHITESPACE = "tapestry.compress-whitespace";
 
     /**
-     * Time interval defining how often Tapestry will check for updates to local files (including classes). This number
-     * can be raised in a production environment. The default is "1 s" (one second), which is appropriate for
-     * development.
+     * Time interval defining how often Tapestry will check for updates to local files (including classes).
+     * Starting with 5.3, this is only used when not running in production mode. The default is "1 s"
+     * (one second), which is appropriate for development. With Tapestry 5.2 and earlier this number
+     * should be raised in a production environment. 
      */
     public static final String FILE_CHECK_INTERVAL = "tapestry.file-check-interval";
 
     /**
      * Time interval that sets how long Tapestry will wait to obtain the exclusive lock needed to check local files. The
-     * default is "50 ms".
+     * default is "50 ms". Starting with 5.3, this is only used when not running in production mode.
      */
     public static final String FILE_CHECK_UPDATE_TIMEOUT = "tapestry.file-check-update-timeout";
 
@@ -146,7 +150,7 @@ public class SymbolConstants
 
     /**
      * If "true" (the default) then GZip compression is enabled for dynamic requests and for static assets. If you are
-     * using a server that handles GZip compression for you, or you don't want to ue the extra processing power
+     * using a server that handles GZip compression for you, or you don't want to use the extra processing power
      * necessary to GZIP requests, then override this to "false".
      *
      * @see #MIN_GZIP_SIZE
@@ -200,7 +204,7 @@ public class SymbolConstants
     public static final String START_PAGE_NAME = "tapestry.start-page-name";
 
     /**
-     * The default stylesheet automatically injected into every rendered HTML page.
+     * The default stylesheet automatically inserted into every rendered HTML page.
      *
      * @since 5.2.0
      * @deprecated Deprecated in 5.4 with no replacement; the stylesheet is now associated with the core {@link JavaScriptStack}.
@@ -390,7 +394,7 @@ public class SymbolConstants
      * many implementations of HttpSession are not thread safe, and often mutable objects are stored in the session and shared
      * between threads. Leaving this on the default will yield a more robust application; setting it to false may speed
      * up processing for more Ajax intensive applications (but care should then be given to ensuring that objects shared inside
-     * the session are themeselves immutable or thread-safe).
+     * the session are themselves immutable or thread-safe).
      *
      * @since 5.4
      */

http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/969b9b1a/tapestry-core/src/main/java/org/apache/tapestry5/TapestryFilter.java
----------------------------------------------------------------------
diff --git a/tapestry-core/src/main/java/org/apache/tapestry5/TapestryFilter.java b/tapestry-core/src/main/java/org/apache/tapestry5/TapestryFilter.java
index eab839d..98fea52 100644
--- a/tapestry-core/src/main/java/org/apache/tapestry5/TapestryFilter.java
+++ b/tapestry-core/src/main/java/org/apache/tapestry5/TapestryFilter.java
@@ -1,4 +1,4 @@
-// Copyright 2006, 2007, 2008, 2009, 2010, 2011, 2012 The Apache Software Foundation
+// Copyright 2006-2013 The Apache Software Foundation
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -63,7 +63,7 @@ public class TapestryFilter implements Filter
     private HttpServletRequestHandler handler;
 
     /**
-     * Key under which that Tapestry IoC {@link org.apache.tapestry5.ioc.Registry} is stored in the
+     * Key under which the Tapestry IoC {@link org.apache.tapestry5.ioc.Registry} is stored in the
      * ServletContext. This
      * allows other code, beyond Tapestry, to obtain the Registry and, from it, any Tapestry
      * services. Such code should
@@ -124,7 +124,7 @@ public class TapestryFilter implements Filter
     /**
      * Invoked from {@link #init(FilterConfig)} after the Registry has been created, to allow any
      * additional
-     * initialization to occur. This implementation does nothing, and my be overriden in subclasses.
+     * initialization to occur. This implementation does nothing, and my be overridden in subclasses.
      *
      * @param registry
      *         from which services may be extracted
@@ -146,7 +146,7 @@ public class TapestryFilter implements Filter
     }
 
     /**
-     * Overriden in subclasses to provide additional module classes beyond those normally located. This implementation
+     * Overridden in subclasses to provide additional module classes beyond those normally located. This implementation
      * returns an empty array.
      *
      * @since 5.3
@@ -175,7 +175,7 @@ public class TapestryFilter implements Filter
     /**
      * Shuts down and discards the registry. Invokes
      * {@link #destroy(org.apache.tapestry5.ioc.Registry)} to allow
-     * subclasses to peform any shutdown logic, then shuts down the registry, and removes it from
+     * subclasses to perform any shutdown logic, then shuts down the registry, and removes it from
      * the ServletContext.
      */
     public final void destroy()

http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/969b9b1a/tapestry-core/src/main/java/org/apache/tapestry5/TapestryMarkers.java
----------------------------------------------------------------------
diff --git a/tapestry-core/src/main/java/org/apache/tapestry5/TapestryMarkers.java b/tapestry-core/src/main/java/org/apache/tapestry5/TapestryMarkers.java
index fed2961..122cfc7 100644
--- a/tapestry-core/src/main/java/org/apache/tapestry5/TapestryMarkers.java
+++ b/tapestry-core/src/main/java/org/apache/tapestry5/TapestryMarkers.java
@@ -1,4 +1,4 @@
-//  Copyright 2008, 2012 The Apache Software Foundation
+//  Copyright 2008-2013 The Apache Software Foundation
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -49,7 +49,7 @@ public class TapestryMarkers
     public static final Marker EVENT_DISPATCH = MarkerFactory.getMarker("EVENT_DISPATCH");
 
     /**
-     * Marker for logging, at trace level verbose details about each individual {@link
+     * Marker for logging, at trace level, verbose details about each individual {@link
      * org.apache.tapestry5.runtime.RenderCommand} involved in rendering the page, as well as a final (debug level)
      * summary of command count and elapsed time.
      */

http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/969b9b1a/tapestry-core/src/main/java/org/apache/tapestry5/ValueEncoder.java
----------------------------------------------------------------------
diff --git a/tapestry-core/src/main/java/org/apache/tapestry5/ValueEncoder.java b/tapestry-core/src/main/java/org/apache/tapestry5/ValueEncoder.java
index c781be6..1318dd0 100644
--- a/tapestry-core/src/main/java/org/apache/tapestry5/ValueEncoder.java
+++ b/tapestry-core/src/main/java/org/apache/tapestry5/ValueEncoder.java
@@ -19,7 +19,7 @@ package org.apache.tapestry5;
  * strings (typically IDs) and back. This mechanism is widely used in Tapestry
  * to allow you to work more seamlessly with objects rather than manually
  * managing the encoding and decoding process throughout your application.
- * 
+ * <p/>
  * Tapestry uses a ValueEncoder when generating an
  * {@link org.apache.tapestry5.EventContext} as part of a URL, and when
  * components (such as {@link org.apache.tapestry5.corelib.components.Select})