You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@velocity.apache.org by cb...@apache.org on 2016/12/05 14:27:56 UTC
svn commit: r1772673 - in /velocity/site/cms/trunk/content/engine/devel:
configuration.mdtext upgrading.mdtext
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).