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 2020/02/02 13:39:12 UTC

svn commit: r1873506 - in /velocity/site/cms/trunk/content: download.mdtext engine/2.2/vtl-reference.mdtext engine/devel/vtl-reference.mdtext engine/index.mdtext index.mdtext left.nav news.xml

Author: cbrisson
Date: Sun Feb  2 13:39:12 2020
New Revision: 1873506

URL: http://svn.apache.org/viewvc?rev=1873506&view=rev
Log:
[site] Update site for engine 2.2 release

Modified:
    velocity/site/cms/trunk/content/download.mdtext
    velocity/site/cms/trunk/content/engine/2.2/vtl-reference.mdtext
    velocity/site/cms/trunk/content/engine/devel/vtl-reference.mdtext
    velocity/site/cms/trunk/content/engine/index.mdtext
    velocity/site/cms/trunk/content/index.mdtext
    velocity/site/cms/trunk/content/left.nav
    velocity/site/cms/trunk/content/news.xml

Modified: velocity/site/cms/trunk/content/download.mdtext
URL: http://svn.apache.org/viewvc/velocity/site/cms/trunk/content/download.mdtext?rev=1873506&r1=1873505&r2=1873506&view=diff
==============================================================================
--- velocity/site/cms/trunk/content/download.mdtext (original)
+++ velocity/site/cms/trunk/content/download.mdtext Sun Feb  2 13:39:12 2020
@@ -47,14 +47,14 @@ These releases are considered stable and
 
 ### Engine
 
-Be sure to check the [release notes](http://www.apache.org/dist/velocity/engine/2.1/release-notes.html) and the [dependencies](http://velocity.apache.org/engine/2.1/dependencies.html).
+Be sure to check the [release notes](http://www.apache.org/dist/velocity/engine/2.2/release-notes.html) and the [dependencies](http://velocity.apache.org/engine/2.2/dependencies.html).
 
 #### Inclusion as a maven dependency
 
     <dependency>
       <groupId>org.apache.velocity</groupId>
       <artifactId>velocity-engine-core</artifactId>
-      <version>2.1</version>
+      <version>2.2</version>
     </dependency>
 
 #### Binaries
@@ -65,21 +65,15 @@ Be sure to check the [release notes](htt
   <tbody>
     <tr>
       <th>engine-core</th>
-      <td><a href="[preferred]/velocity/engine/2.1/velocity-engine-core-2.1.jar">velocity-engine-core-2.1.jar</a></td>
-      <td>[<a href="https://www.apache.org/dist/velocity/engine/2.1/velocity-engine-core-2.1.jar.asc">PGP</a>]</td>
-      <td>[<a href="https://www.apache.org/dist/velocity/engine/2.1/velocity-engine-core-2.1.jar.sha256">SHA256</a>]</td>
+      <td><a href="[preferred]/velocity/engine/2.2/velocity-engine-core-2.2.jar">velocity-engine-core-2.2.jar</a></td>
+      <td>[<a href="https://www.apache.org/dist/velocity/engine/2.2/velocity-engine-core-2.2.jar.asc">PGP</a>]</td>
+      <td>[<a href="https://www.apache.org/dist/velocity/engine/2.2/velocity-engine-core-2.2.jar.sha256">SHA256</a>]</td>
     </tr>
     <tr>
       <th>engine-scripting</th>
-      <td><a href="[preferred]/velocity/engine/2.1/velocity-engine-scripting-2.1.jar">velocity-engine-scripting-2.1.jar</a></td>
-      <td>[<a href="https://www.apache.org/dist/velocity/engine/2.1/velocity-engine-scripting-2.1.jar.asc">PGP</a>]</td>
-      <td>[<a href="https://www.apache.org/dist/velocity/engine/2.1/velocity-engine-scripting-2.1.jar.sha256">SHA256</a>]</td>
-    </tr>
-    <tr>
-      <th>engine-examples</th>
-      <td><a href="[preferred]/velocity/engine/2.1/velocity-engine-examples-2.1.jar">velocity-engine-examples-2.1.jar</a></td>
-      <td>[<a href="https://www.apache.org/dist/velocity/engine/2.1/velocity-engine-examples-2.1.jar.asc">PGP</a>]</td>
-      <td>[<a href="https://www.apache.org/dist/velocity/engine/2.1/velocity-engine-examples-2.1.jar.sha256">SHA256</a>]</td>
+      <td><a href="[preferred]/velocity/engine/2.2/velocity-engine-scripting-2.2.jar">velocity-engine-scripting-2.2.jar</a></td>
+      <td>[<a href="https://www.apache.org/dist/velocity/engine/2.2/velocity-engine-scripting-2.2.jar.asc">PGP</a>]</td>
+      <td>[<a href="https://www.apache.org/dist/velocity/engine/2.2/velocity-engine-scripting-2.2.jar.sha256">SHA256</a>]</td>
     </tr>
   </tbody>
 </table>
@@ -92,21 +86,21 @@ Be sure to check the [release notes](htt
   <tbody>
     <tr>
       <th>engine-core</th>
-      <td><a href="[preferred]/velocity/engine/2.1/velocity-engine-core-2.1.pom">velocity-engine-core-2.1.pom</a></td>
-      <td>[<a href="https://www.apache.org/dist/velocity/engine/2.1/velocity-engine-core-2.1.pom.asc">PGP</a>]</td>
-      <td>[<a href="https://www.apache.org/dist/velocity/engine/2.1/velocity-engine-core-2.1.pom.sha256">SHA256</a>]</td>
+      <td><a href="[preferred]/velocity/engine/2.2/velocity-engine-core-2.2.pom">velocity-engine-core-2.2.pom</a></td>
+      <td>[<a href="https://www.apache.org/dist/velocity/engine/2.2/velocity-engine-core-2.2.pom.asc">PGP</a>]</td>
+      <td>[<a href="https://www.apache.org/dist/velocity/engine/2.2/velocity-engine-core-2.2.pom.sha256">SHA256</a>]</td>
     </tr>
     <tr>
       <th>engine-scripting</th>
-      <td><a href="[preferred]/velocity/engine/2.1/velocity-engine-scripting-2.1.pom">velocity-engine-scripting-2.1.pom</a></td>
-      <td>[<a href="https://www.apache.org/dist/velocity/engine/2.1/velocity-engine-scripting-2.1.pom.asc">PGP</a>]</td>
-      <td>[<a href="https://www.apache.org/dist/velocity/engine/2.1/velocity-engine-scripting-2.1.pom.sha256">SHA256</a>]</td>
+      <td><a href="[preferred]/velocity/engine/2.2/velocity-engine-scripting-2.2.pom">velocity-engine-scripting-2.2.pom</a></td>
+      <td>[<a href="https://www.apache.org/dist/velocity/engine/2.2/velocity-engine-scripting-2.2.pom.asc">PGP</a>]</td>
+      <td>[<a href="https://www.apache.org/dist/velocity/engine/2.2/velocity-engine-scripting-2.2.pom.sha256">SHA256</a>]</td>
     </tr>
     <tr>
-      <th>engine-examples</th>
-      <td><a href="[preferred]/velocity/engine/2.1/velocity-engine-examples-2.1.pom">velocity-engine-examples-2.1.pom</a></td>
-      <td>[<a href="https://www.apache.org/dist/velocity/engine/2.1/velocity-engine-examples-2.1.pom.asc">PGP</a>]</td>
-      <td>[<a href="https://www.apache.org/dist/velocity/engine/2.1/velocity-engine-examples-2.1.pom.sha256">SHA256</a>]</td>
+      <th>velocity-custom-parser-example</th>
+      <td><a href="[preferred]/velocity/engine/2.2/velocity-custom-parser-example-2.2.pom">velocity-engine-scripting-2.2.pom</a></td>
+      <td>[<a href="https://www.apache.org/dist/velocity/engine/2.2/velocity-custom-parser-example-2.2.pom.asc">PGP</a>]</td>
+      <td>[<a href="https://www.apache.org/dist/velocity/engine/2.2/velocity-custom-parser-example-2.2.pom.sha256">SHA256</a>]</td>
     </tr>
   </tbody>
 </table>
@@ -119,21 +113,15 @@ Be sure to check the [release notes](htt
   <tbody>
     <tr>
       <th>engine-core</th>
-      <td><a href="[preferred]/velocity/engine/2.1/velocity-engine-core-2.1-javadoc.jar">velocity-engine-core-2.1-javadoc.jar</a></td>
-      <td>[<a href="https://www.apache.org/dist/velocity/engine/2.1/velocity-engine-core-2.1-javadoc.jar.asc">PGP</a>]</td>
-      <td>[<a href="https://www.apache.org/dist/velocity/engine/2.1/velocity-engine-core-2.1-javadoc.jar.sha256">SHA256</a>]</td>
+      <td><a href="[preferred]/velocity/engine/2.2/velocity-engine-core-2.2-javadoc.jar">velocity-engine-core-2.2-javadoc.jar</a></td>
+      <td>[<a href="https://www.apache.org/dist/velocity/engine/2.2/velocity-engine-core-2.2-javadoc.jar.asc">PGP</a>]</td>
+      <td>[<a href="https://www.apache.org/dist/velocity/engine/2.2/velocity-engine-core-2.2-javadoc.jar.sha256">SHA256</a>]</td>
     </tr>
     <tr>
       <th>engine-scripting</th>
-      <td><a href="[preferred]/velocity/engine/2.1/velocity-engine-scripting-2.1-javadoc.jar">velocity-engine-scripting-2.1-javadoc.jar</a></td>
-      <td>[<a href="https://www.apache.org/dist/velocity/engine/2.1/velocity-engine-scripting-2.1-javadoc.jar.asc">PGP</a>]</td>
-      <td>[<a href="https://www.apache.org/dist/velocity/engine/2.1/velocity-engine-scripting-2.1-javadoc.jar.sha256">SHA256</a>]</td>
-    </tr>
-    <tr>
-      <th>engine-examples</th>
-      <td><a href="[preferred]/velocity/engine/2.1/velocity-engine-examples-2.1-javadoc.jar">velocity-engine-examples-2.1-javadoc.jar</a></td>
-      <td>[<a href="https://www.apache.org/dist/velocity/engine/2.1/velocity-engine-examples-2.1-javadoc.jar.asc">PGP</a>]</td>
-      <td>[<a href="https://www.apache.org/dist/velocity/engine/2.1/velocity-engine-examples-2.1-javadoc.jar.sha256">SHA256</a>]</td>
+      <td><a href="[preferred]/velocity/engine/2.2/velocity-engine-scripting-2.2-javadoc.jar">velocity-engine-scripting-2.2-javadoc.jar</a></td>
+      <td>[<a href="https://www.apache.org/dist/velocity/engine/2.2/velocity-engine-scripting-2.2-javadoc.jar.asc">PGP</a>]</td>
+      <td>[<a href="https://www.apache.org/dist/velocity/engine/2.2/velocity-engine-scripting-2.2-javadoc.jar.sha256">SHA256</a>]</td>
     </tr>
   </tbody>
 </table>
@@ -146,26 +134,34 @@ Be sure to check the [release notes](htt
   <tbody>
     <tr>
       <th>engine-core</th>
-      <td><a href="[preferred]/velocity/engine/2.1/velocity-engine-core-2.1-sources.jar">velocity-engine-core-2.1-sources.jar</a></td>
-      <td>[<a href="https://www.apache.org/dist/velocity/engine/2.1/velocity-engine-core-2.1-sources.jar.asc">PGP</a>]</td>
-      <td>[<a href="https://www.apache.org/dist/velocity/engine/2.1/velocity-engine-core-2.1-sources.jar.sha256">SHA256</a>]</td>
+      <td><a href="[preferred]/velocity/engine/2.2/velocity-engine-core-2.2-sources.jar">velocity-engine-core-2.2-sources.jar</a></td>
+      <td>[<a href="https://www.apache.org/dist/velocity/engine/2.2/velocity-engine-core-2.2-sources.jar.asc">PGP</a>]</td>
+      <td>[<a href="https://www.apache.org/dist/velocity/engine/2.2/velocity-engine-core-2.2-sources.jar.sha256">SHA256</a>]</td>
     </tr>
     <tr>
       <th>engine-scripting</th>
-      <td><a href="[preferred]/velocity/engine/2.1/velocity-engine-scripting-2.1-sources.jar">velocity-engine-scripting-2.1-sources.jar</a></td>
-      <td>[<a href="https://www.apache.org/dist/velocity/engine/2.1/velocity-engine-scripting-2.1-sources.jar.asc">PGP</a>]</td>
-      <td>[<a href="https://www.apache.org/dist/velocity/engine/2.1/velocity-engine-scripting-2.1-sources.jar.sha256">SHA256</a>]</td>
+      <td><a href="[preferred]/velocity/engine/2.2/velocity-engine-scripting-2.2-sources.jar">velocity-engine-scripting-2.2-sources.jar</a></td>
+      <td>[<a href="https://www.apache.org/dist/velocity/engine/2.2/velocity-engine-scripting-2.2-sources.jar.asc">PGP</a>]</td>
+      <td>[<a href="https://www.apache.org/dist/velocity/engine/2.2/velocity-engine-scripting-2.2-sources.jar.sha256">SHA256</a>]</td>
     </tr>
+  </tbody>
+</table>
+
+#### Examples
+
+<table class="smalltable">
+  <thead>
+  </thead>
+  <tbody>
     <tr>
-      <th>engine-examples</th>
-      <td><a href="[preferred]/velocity/engine/2.1/velocity-engine-examples-2.1-sources.jar">velocity-engine-examples-2.1-sources.jar</a></td>
-      <td>[<a href="https://www.apache.org/dist/velocity/engine/2.1/velocity-engine-examples-2.1-sources.jar.asc">PGP</a>]</td>
-      <td>[<a href="https://www.apache.org/dist/velocity/engine/2.1/velocity-engine-examples-2.1-sources.jar.sha256">SHA256</a>]</td>
+      <th>velocity-engine-examples</th>
+      <td><a href="[preferred]/velocity/engine/2.2/velocity-engine-examples-2.2.zip">velocity-engine-examples.zip</a></td>
+      <td>[<a href="https://www.apache.org/dist/velocity/engine/2.2/velocity-engine-examples-2.2.zip.asc">PGP</a>]</td>
+      <td>[<a href="https://www.apache.org/dist/velocity/engine/2.2/velocity-engine-examples-2.2.zip.sha256">SHA256</a>]</td>
     </tr>
   </tbody>
 </table>
 
-
 ### Tools
 
 #### Inclusion as a maven dependency

Modified: velocity/site/cms/trunk/content/engine/2.2/vtl-reference.mdtext
URL: http://svn.apache.org/viewvc/velocity/site/cms/trunk/content/engine/2.2/vtl-reference.mdtext?rev=1873506&r1=1873505&r2=1873506&view=diff
==============================================================================
--- velocity/site/cms/trunk/content/engine/2.2/vtl-reference.mdtext (original)
+++ velocity/site/cms/trunk/content/engine/2.2/vtl-reference.mdtext Sun Feb  2 13:39:12 2020
@@ -304,7 +304,7 @@ Since 2.0, when a macro argument is null
     #macro( vmname $foo ) $foo #end
     #vmname( $null )
 
-will display `$foo`. If you wish to revert to the 1.x behavior (which is to display `$null`), you can set the `velocimacro.preserve.arguments.literals` configuration property to true (since 2.1).
+will display `$foo`. If you wish to revert to the 1.x behavior (which is to display `$null`), you can set the `velocimacro.enable_bc_mode` configuration property to true (since 2.2).
 
 ## Comments
 

Modified: velocity/site/cms/trunk/content/engine/devel/vtl-reference.mdtext
URL: http://svn.apache.org/viewvc/velocity/site/cms/trunk/content/engine/devel/vtl-reference.mdtext?rev=1873506&r1=1873505&r2=1873506&view=diff
==============================================================================
--- velocity/site/cms/trunk/content/engine/devel/vtl-reference.mdtext (original)
+++ velocity/site/cms/trunk/content/engine/devel/vtl-reference.mdtext Sun Feb  2 13:39:12 2020
@@ -304,7 +304,7 @@ Since 2.0, when a macro argument is null
     #macro( vmname $foo ) $foo #end
     #vmname( $null )
 
-will display `$foo`. If you wish to revert to the 1.x behavior (which is to display `$null`), you can set the `velocimacro.preserve.arguments.literals` configuration property to true (since 2.1).
+will display `$foo`. If you wish to revert to the 1.x behavior (which is to display `$null`), you can set the `velocimacro.enable_bc_mode` configuration property to true (since 2.2).
 
 ## Comments
 

Modified: velocity/site/cms/trunk/content/engine/index.mdtext
URL: http://svn.apache.org/viewvc/velocity/site/cms/trunk/content/engine/index.mdtext?rev=1873506&r1=1873505&r2=1873506&view=diff
==============================================================================
--- velocity/site/cms/trunk/content/engine/index.mdtext (original)
+++ velocity/site/cms/trunk/content/engine/index.mdtext Sun Feb  2 13:39:12 2020
@@ -8,11 +8,12 @@ Velocity permits you to use a simple yet
 
 The Velocity engine subproject contains the documentation to get started using the Velocity templating language and embedding Velocity into your own applications. Please select [the last released version](1.7) to get started. Once you are more familiar with Velocity or if you need a feature not yet released, you can check out the [Development Site](devel).
 
-+ [Engine 2.1](2.1) pages.
++ [Engine 2.2](2.2) pages.
 + [Engine Development Version](devel/) pages.
 
 ## Older Releases
 
++ [Engine 2.1 Release](2.1)
 + [Engine 2.0 Release](2.0)
 + [Engine 1.7 Release](1.7)
 + [Engine 1.6.2 Release](1.6.2)

Modified: velocity/site/cms/trunk/content/index.mdtext
URL: http://svn.apache.org/viewvc/velocity/site/cms/trunk/content/index.mdtext?rev=1873506&r1=1873505&r2=1873506&view=diff
==============================================================================
--- velocity/site/cms/trunk/content/index.mdtext (original)
+++ velocity/site/cms/trunk/content/index.mdtext Sun Feb  2 13:39:12 2020
@@ -37,7 +37,7 @@ Apache Velocity offers the following pro
 
 Project | Release Version | Alpha/Beta/RC Release Version
 --------|-----------------|------------------------------
-Velocity Engine | 2.1 | (currently none available)
+Velocity Engine | 2.2 | (currently none available)
 Velocity Tools | 3.0 | (currently none available)
 
 The release distribution is available as a combined source/binary distribution in tar.gz and zip formats, and can be downloaded from [our download page](/download/cgi).

Modified: velocity/site/cms/trunk/content/left.nav
URL: http://svn.apache.org/viewvc/velocity/site/cms/trunk/content/left.nav?rev=1873506&r1=1873505&r2=1873506&view=diff
==============================================================================
--- velocity/site/cms/trunk/content/left.nav (original)
+++ velocity/site/cms/trunk/content/left.nav Sun Feb  2 13:39:12 2020
@@ -3,7 +3,7 @@
 * [News](/news.html)
 * [Downloads](/download.cgi)
 ## Releases
-* [Engine 2.1](/engine/2.1)
+* [Engine 2.2](/engine/2.2)
 * [Tools 3.0](/tools/3.0)
 ## Development
 * [Engine](/engine/devel)

Modified: velocity/site/cms/trunk/content/news.xml
URL: http://svn.apache.org/viewvc/velocity/site/cms/trunk/content/news.xml?rev=1873506&r1=1873505&r2=1873506&view=diff
==============================================================================
--- velocity/site/cms/trunk/content/news.xml (original)
+++ velocity/site/cms/trunk/content/news.xml Sun Feb  2 13:39:12 2020
@@ -2,6 +2,31 @@
 
 <news xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://velocity.apache.org/NEWS/1.0.0" xsi:schemaLocation="http://velocity.apache.org/NEWS/1.0.0 http://velocity.apache.org/site/tools/velocity-site-news/xsd/news-1.0.0.xsd">
   <items>
+    <item id="engine22">
+        <date>2020-02-02</date>
+        <headline>Velocity Engine 2.2 released</headline>
+      <categories>
+        <category>velocity</category>
+        <category>engine</category>
+      </categories>
+      <text><![CDATA[
+        The Velocity developers are pleased to announce the release of Velocity Engine 2.2.
+
+        Main changes in this release:
+
+        + New runtime.log.track_locations debugging configuration flag which displays the VTL stack trace in the logs in cases of errors, and populates slf4j MDC tags about position in VTL templates.
+
+        + New example of how to build a customized VTL parser where the '#', '$', '*' and '@' characters can be replaced by alternate characters.
+
+        + New backward compatibility flags to mimic 1.7.x event handlers and velicomacros behaviors.
+
+        For a full list of changes, consult {{{http://velocity.apache.org/engine/2.2/changes.html}Velocity Engine 2.2 Changes section}} and {{{https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12310104&version=12345391}JIRA changelog}}.
+
+        For notes on upgrading, see {{{http://velocity.apache.org/engine/2.2/upgrading.html}Velocity Engine 2.2 Upgrading section}}.
+
+        Downloads of 2.2 are available {{{http://velocity.apache.org/download.cgi#engine}here}}.
+      ]]></text>
+    </item>
     <item id="engine21">
         <date>2019-03-31</date>
         <headline>Velocity Engine 2.1 released</headline>