Author: byron
Date: Fri Jan 23 03:46:28 2009
New Revision: 737015
URL: http://svn.apache.org/viewvc?rev=737015&view=rev
Log:
VELOCITY-623 Added documentation and changelog entry
Modified:
velocity/engine/trunk/src/changes/changes.xml
velocity/engine/trunk/xdocs/docs/developer-guide.xml
Modified: velocity/engine/trunk/src/changes/changes.xml
URL:
http://svn.apache.org/viewvc/velocity/engine/trunk/src/changes/changes.xml?rev=737015&r1=737014&r2=737015&view=diff
==============================================================================
--- velocity/engine/trunk/src/changes/changes.xml (original)
+++ velocity/engine/trunk/src/changes/changes.xml Fri Jan 23 03:46:28 2009
@@ -27,6 +27,12 @@
<body>
<release version="1.7" date="In Subversion">
+ <action type="add" dev="byron" issue="VELOCITY-623">
+ Added a property for changing escape behavior such that putting a
forward
+ slash before a reference or macro always escapes the reference or macro
and
+ absorbs the forward slash regardless if the reference or macro is
defined.
+ </action>
+
<action type="fix" dev="nbubna" issue="VELOCITY-676" due-to="Jarkko
Viinamäki">
Fix StringIndexOutOfBoundsException caused by #[[##x]]# (line comment
on
same line as end of textblock).
Modified: velocity/engine/trunk/xdocs/docs/developer-guide.xml
URL:
http://svn.apache.org/viewvc/velocity/engine/trunk/xdocs/docs/developer-guide.xml?rev=737015&r1=737014&r2=737015&view=diff
==============================================================================
--- velocity/engine/trunk/xdocs/docs/developer-guide.xml (original)
+++ velocity/engine/trunk/xdocs/docs/developer-guide.xml Fri Jan 23 03:46:28
2009
@@ -1896,6 +1896,19 @@
</p>
<p>
+<code>runtime.references.strict.escape = false</code> Changes escape
+behavior such that putting a forward slash before a reference or
+macro always escapes the reference or macro and absorbs the forward
+slash regardless if the reference or macro is defined. For example
+"\$foo" always renders as "$foo", or "\#foo()" is always rendered as
+"#foo()". This escape behavior is of use in strict mode since
+unintended strings of characters that look like references or macros
+will throw an exception. This provides an easy way to escape these
+references. However, even in non-strict mode the developer may find
+this a more consistent and reliable method for escaping.
+</p>
+
+<p>
<strong>String Interpolation</strong>
</p>
