Mailing-List: contact commits-help@velocity.apache.org; run by ezmlm
Precedence: bulk
Reply-To: dev@velocity.apache.org
Content-Type: text/plain; charset="utf-8"
MIME-Version: 1.0
Content-Transfer-Encoding: 7bit
Subject: svn commit: r1772673 - in /velocity/site/cms/trunk/content/engine/devel:
 configuration.mdtext upgrading.mdtext
Date: Mon, 05 Dec 2016 14:27:56 -0000
To: commits@velocity.apache.org
From: cbrisson@apache.org
Message-Id: <20161205142756.A0DCB3A0257@svn01-us-west.apache.org>
archived-at: Mon, 05 Dec 2016 14:28:01 -0000

Author: cbrisson
Date: Mon Dec  5 14:27:55 2016
New Revision: 1772673

URL: http://svn.apache.org/viewvc?rev=1772673&view=rev
Log:
[site/engine] document UTF-8 as default encoding

Modified:
    velocity/site/cms/trunk/content/engine/devel/configuration.mdtext
    velocity/site/cms/trunk/content/engine/devel/upgrading.mdtext

Modified: velocity/site/cms/trunk/content/engine/devel/configuration.mdtext
URL: http://svn.apache.org/viewvc/velocity/site/cms/trunk/content/engine/devel/configuration.mdtext?rev=1772673&r1=1772672&r2=1772673&view=diff
==============================================================================
--- velocity/site/cms/trunk/content/engine/devel/configuration.mdtext (original)
+++ velocity/site/cms/trunk/content/engine/devel/configuration.mdtext Mon Dec  5 14:27:55 2016
@@ -34,7 +34,7 @@ Below are listed the configuration keys
 
 **`input.encoding = UTF-8`**
 
-> Character encoding for input (templates). If not specified, Velocity relies on the 'file.encoding' system property.
+> Character encoding for input (templates). UTF-8 if not specified.
 
 ## VTL Directives
 

Modified: velocity/site/cms/trunk/content/engine/devel/upgrading.mdtext
URL: http://svn.apache.org/viewvc/velocity/site/cms/trunk/content/engine/devel/upgrading.mdtext?rev=1772673&r1=1772672&r2=1772673&view=diff
==============================================================================
--- velocity/site/cms/trunk/content/engine/devel/upgrading.mdtext (original)
+++ velocity/site/cms/trunk/content/engine/devel/upgrading.mdtext Mon Dec  5 14:27:55 2016
@@ -24,8 +24,8 @@ Read below for futher details.
     + the reference could be successfully evaluated but resulted in a null value
     + the reference is tested for validity inside an #if / #elseif statement
     The 1.x behavior did send invalid reference events in all those cases.
-+ The `ResourceLoader` class has been deprecated in favor of a `ResourceLoader2` class, in which the `InputStream ResourceLoader.getResourceStream(String name)` has been replaced by a `Reader ResourceLoader.getResourceReader(String name, String encoding)`. Since `ResourceLoader` inherits from `ResourceLoader2`, the change remains backward compatible, but custom resource loaders should be upgraded to avoid deprecattion warnings.
-+ the default encoding ('ISO-8859-1' in 1.x) is now read from the standard `file.encoding` Java system property.
++ The `ResourceLoader` class has been deprecated in favor of a `ResourceLoader2` class, in which the `InputStream ResourceLoader.getResourceStream(String name)` has been replaced by a `Reader ResourceLoader.getResourceReader(String name, String encoding)`. Since `ResourceLoader` inherits from `ResourceLoader2`, the change remains backward compatible, but custom resource loaders should be upgraded to avoid deprecation warnings.
++ the default encoding ('ISO-8859-1' in 1.x) is now UTF-8.
 + the MethodException event handler now receives an additional argument providing template name and location infos.
 + all occurences of the class org.apache.commons.collections.ExtendedProperties in the initialization API have been replaced by org.apache.velocity.util.ExtProperties.
 + the macros are now using a 'call by sharing' convention (which means that all arguments are evaluated once at start, and that the macro receives a copy of the reference to each argument).