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).
