jon         01/02/12 12:03:40

  Modified:    docs     anakia.html code-standards.html contributors.html
                        design.html developer-guide.html
                        getting-started.html index.html install.html
                        license.html migration.html texen.html todo.html
                        user-guide.html vtl-reference-guide.html
               xdocs    site-book.xml texen.xml
  Added:       docs     differences.html
               xdocs    differences.xml
  Log:
  added wm/vm differences based on geir's email (i'm tired of seeing the same
  things repeated over and over again on the list <smile>)
  
  fixed texen example to use new #set syntax
  
  Revision  Changes    Path
  1.6       +2 -1      jakarta-velocity/docs/anakia.html
  
  Index: anakia.html
  ===================================================================
  RCS file: /home/cvs/jakarta-velocity/docs/anakia.html,v
  retrieving revision 1.5
  retrieving revision 1.6
  diff -u -r1.5 -r1.6
  --- anakia.html       2001/01/11 03:37:46     1.5
  +++ anakia.html       2001/02/12 20:03:23     1.6
  @@ -13,6 +13,7 @@
       <FONT face="arial,helvetica,sanserif" size="-1"><LI><A 
href="user-guide.html">User's Guide</A></LI></FONT>
       <FONT face="arial,helvetica,sanserif" size="-1"><LI><A 
href="developer-guide.html">Developer's Guide</A></LI></FONT>
       <FONT face="arial,helvetica,sanserif" size="-1"><LI><A 
href="vtl-reference-guide.html">VTL Reference Guide</A></LI></FONT>
  +    <FONT face="arial,helvetica,sanserif" size="-1"><LI><A 
href="differences.html">VM/WM Differences</A></LI></FONT>
   <P>Tools</P>
       <FONT face="arial,helvetica,sanserif" size="-1"><LI><A 
href="anakia.html">Anakia</A></LI></FONT>
       <FONT face="arial,helvetica,sanserif" size="-1"><LI><A 
href="texen.html">Texen</A></LI></FONT>
  @@ -330,6 +331,6 @@
   
   
   </TD></TR></TABLE></TD></TR></TABLE><BR><TABLE border="0" cellpadding="0" 
cellspacing="0" width="100%"><TR><TD bgcolor="#023264"><IMG height="1" 
src="resources/resources.gif" width="1"></TD></TR><TR><TD align="center"><FONT 
color="#023264" face="arial,helvetica,sanserif" size="-1"><I>
  -              Copyright &copy; 2000 The Apache Software Foundation.
  +              Copyright &copy; 2000-2001 The Apache Software Foundation.
                 All Rights Reserved.
               </I></FONT></TD></TR></TABLE></BODY></HTML>
  
  
  
  1.12      +2 -1      jakarta-velocity/docs/code-standards.html
  
  Index: code-standards.html
  ===================================================================
  RCS file: /home/cvs/jakarta-velocity/docs/code-standards.html,v
  retrieving revision 1.11
  retrieving revision 1.12
  diff -u -r1.11 -r1.12
  --- code-standards.html       2000/11/23 01:29:29     1.11
  +++ code-standards.html       2001/02/12 20:03:24     1.12
  @@ -13,6 +13,7 @@
       <FONT face="arial,helvetica,sanserif" size="-1"><LI><A 
href="user-guide.html">User's Guide</A></LI></FONT>
       <FONT face="arial,helvetica,sanserif" size="-1"><LI><A 
href="developer-guide.html">Developer's Guide</A></LI></FONT>
       <FONT face="arial,helvetica,sanserif" size="-1"><LI><A 
href="vtl-reference-guide.html">VTL Reference Guide</A></LI></FONT>
  +    <FONT face="arial,helvetica,sanserif" size="-1"><LI><A 
href="differences.html">VM/WM Differences</A></LI></FONT>
   <P>Tools</P>
       <FONT face="arial,helvetica,sanserif" size="-1"><LI><A 
href="anakia.html">Anakia</A></LI></FONT>
       <FONT face="arial,helvetica,sanserif" size="-1"><LI><A 
href="texen.html">Texen</A></LI></FONT>
  @@ -124,6 +125,6 @@
   
   
   </TD></TR></TABLE></TD></TR></TABLE><BR><TABLE border="0" cellpadding="0" 
cellspacing="0" width="100%"><TR><TD bgcolor="#023264"><IMG height="1" 
src="resources/resources.gif" width="1"></TD></TR><TR><TD align="center"><FONT 
color="#023264" face="arial,helvetica,sanserif" size="-1"><I>
  -              Copyright &copy; 2000 The Apache Software Foundation.
  +              Copyright &copy; 2000-2001 The Apache Software Foundation.
                 All Rights Reserved.
               </I></FONT></TD></TR></TABLE></BODY></HTML>
  
  
  
  1.16      +2 -1      jakarta-velocity/docs/contributors.html
  
  Index: contributors.html
  ===================================================================
  RCS file: /home/cvs/jakarta-velocity/docs/contributors.html,v
  retrieving revision 1.15
  retrieving revision 1.16
  diff -u -r1.15 -r1.16
  --- contributors.html 2000/11/23 01:29:29     1.15
  +++ contributors.html 2001/02/12 20:03:25     1.16
  @@ -13,6 +13,7 @@
       <FONT face="arial,helvetica,sanserif" size="-1"><LI><A 
href="user-guide.html">User's Guide</A></LI></FONT>
       <FONT face="arial,helvetica,sanserif" size="-1"><LI><A 
href="developer-guide.html">Developer's Guide</A></LI></FONT>
       <FONT face="arial,helvetica,sanserif" size="-1"><LI><A 
href="vtl-reference-guide.html">VTL Reference Guide</A></LI></FONT>
  +    <FONT face="arial,helvetica,sanserif" size="-1"><LI><A 
href="differences.html">VM/WM Differences</A></LI></FONT>
   <P>Tools</P>
       <FONT face="arial,helvetica,sanserif" size="-1"><LI><A 
href="anakia.html">Anakia</A></LI></FONT>
       <FONT face="arial,helvetica,sanserif" size="-1"><LI><A 
href="texen.html">Texen</A></LI></FONT>
  @@ -177,6 +178,6 @@
   
   
   </TD></TR></TABLE></TD></TR></TABLE><BR><TABLE border="0" cellpadding="0" 
cellspacing="0" width="100%"><TR><TD bgcolor="#023264"><IMG height="1" 
src="resources/resources.gif" width="1"></TD></TR><TR><TD align="center"><FONT 
color="#023264" face="arial,helvetica,sanserif" size="-1"><I>
  -              Copyright &copy; 2000 The Apache Software Foundation.
  +              Copyright &copy; 2000-2001 The Apache Software Foundation.
                 All Rights Reserved.
               </I></FONT></TD></TR></TABLE></BODY></HTML>
  
  
  
  1.13      +2 -1      jakarta-velocity/docs/design.html
  
  Index: design.html
  ===================================================================
  RCS file: /home/cvs/jakarta-velocity/docs/design.html,v
  retrieving revision 1.12
  retrieving revision 1.13
  diff -u -r1.12 -r1.13
  --- design.html       2000/11/23 01:29:29     1.12
  +++ design.html       2001/02/12 20:03:25     1.13
  @@ -13,6 +13,7 @@
       <FONT face="arial,helvetica,sanserif" size="-1"><LI><A 
href="user-guide.html">User's Guide</A></LI></FONT>
       <FONT face="arial,helvetica,sanserif" size="-1"><LI><A 
href="developer-guide.html">Developer's Guide</A></LI></FONT>
       <FONT face="arial,helvetica,sanserif" size="-1"><LI><A 
href="vtl-reference-guide.html">VTL Reference Guide</A></LI></FONT>
  +    <FONT face="arial,helvetica,sanserif" size="-1"><LI><A 
href="differences.html">VM/WM Differences</A></LI></FONT>
   <P>Tools</P>
       <FONT face="arial,helvetica,sanserif" size="-1"><LI><A 
href="anakia.html">Anakia</A></LI></FONT>
       <FONT face="arial,helvetica,sanserif" size="-1"><LI><A 
href="texen.html">Texen</A></LI></FONT>
  @@ -94,6 +95,6 @@
   
   
   </TD></TR></TABLE></TD></TR></TABLE><BR><TABLE border="0" cellpadding="0" 
cellspacing="0" width="100%"><TR><TD bgcolor="#023264"><IMG height="1" 
src="resources/resources.gif" width="1"></TD></TR><TR><TD align="center"><FONT 
color="#023264" face="arial,helvetica,sanserif" size="-1"><I>
  -              Copyright &copy; 2000 The Apache Software Foundation.
  +              Copyright &copy; 2000-2001 The Apache Software Foundation.
                 All Rights Reserved.
               </I></FONT></TD></TR></TABLE></BODY></HTML>
  
  
  
  1.16      +2 -1      jakarta-velocity/docs/developer-guide.html
  
  Index: developer-guide.html
  ===================================================================
  RCS file: /home/cvs/jakarta-velocity/docs/developer-guide.html,v
  retrieving revision 1.15
  retrieving revision 1.16
  diff -u -r1.15 -r1.16
  --- developer-guide.html      2001/02/12 03:32:21     1.15
  +++ developer-guide.html      2001/02/12 20:03:26     1.16
  @@ -13,6 +13,7 @@
       <FONT face="arial,helvetica,sanserif" size="-1"><LI><A 
href="user-guide.html">User's Guide</A></LI></FONT>
       <FONT face="arial,helvetica,sanserif" size="-1"><LI><A 
href="developer-guide.html">Developer's Guide</A></LI></FONT>
       <FONT face="arial,helvetica,sanserif" size="-1"><LI><A 
href="vtl-reference-guide.html">VTL Reference Guide</A></LI></FONT>
  +    <FONT face="arial,helvetica,sanserif" size="-1"><LI><A 
href="differences.html">VM/WM Differences</A></LI></FONT>
   <P>Tools</P>
       <FONT face="arial,helvetica,sanserif" size="-1"><LI><A 
href="anakia.html">Anakia</A></LI></FONT>
       <FONT face="arial,helvetica,sanserif" size="-1"><LI><A 
href="texen.html">Texen</A></LI></FONT>
  @@ -654,6 +655,6 @@
   </FONT></TD></TR></TABLE></DIV><BR>
   
   </TD></TR></TABLE></TD></TR></TABLE><BR><TABLE border="0" cellpadding="0" 
cellspacing="0" width="100%"><TR><TD bgcolor="#023264"><IMG height="1" 
src="resources/resources.gif" width="1"></TD></TR><TR><TD align="center"><FONT 
color="#023264" face="arial,helvetica,sanserif" size="-1"><I>
  -              Copyright &copy; 2000 The Apache Software Foundation.
  +              Copyright &copy; 2000-2001 The Apache Software Foundation.
                 All Rights Reserved.
               </I></FONT></TD></TR></TABLE></BODY></HTML>
  
  
  
  1.14      +2 -1      jakarta-velocity/docs/getting-started.html
  
  Index: getting-started.html
  ===================================================================
  RCS file: /home/cvs/jakarta-velocity/docs/getting-started.html,v
  retrieving revision 1.13
  retrieving revision 1.14
  diff -u -r1.13 -r1.14
  --- getting-started.html      2001/01/11 03:37:46     1.13
  +++ getting-started.html      2001/02/12 20:03:27     1.14
  @@ -13,6 +13,7 @@
       <FONT face="arial,helvetica,sanserif" size="-1"><LI><A 
href="user-guide.html">User's Guide</A></LI></FONT>
       <FONT face="arial,helvetica,sanserif" size="-1"><LI><A 
href="developer-guide.html">Developer's Guide</A></LI></FONT>
       <FONT face="arial,helvetica,sanserif" size="-1"><LI><A 
href="vtl-reference-guide.html">VTL Reference Guide</A></LI></FONT>
  +    <FONT face="arial,helvetica,sanserif" size="-1"><LI><A 
href="differences.html">VM/WM Differences</A></LI></FONT>
   <P>Tools</P>
       <FONT face="arial,helvetica,sanserif" size="-1"><LI><A 
href="anakia.html">Anakia</A></LI></FONT>
       <FONT face="arial,helvetica,sanserif" size="-1"><LI><A 
href="texen.html">Texen</A></LI></FONT>
  @@ -59,6 +60,6 @@
   
   
   </TD></TR></TABLE></TD></TR></TABLE><BR><TABLE border="0" cellpadding="0" 
cellspacing="0" width="100%"><TR><TD bgcolor="#023264"><IMG height="1" 
src="resources/resources.gif" width="1"></TD></TR><TR><TD align="center"><FONT 
color="#023264" face="arial,helvetica,sanserif" size="-1"><I>
  -              Copyright &copy; 2000 The Apache Software Foundation.
  +              Copyright &copy; 2000-2001 The Apache Software Foundation.
                 All Rights Reserved.
               </I></FONT></TD></TR></TABLE></BODY></HTML>
  
  
  
  1.14      +2 -1      jakarta-velocity/docs/index.html
  
  Index: index.html
  ===================================================================
  RCS file: /home/cvs/jakarta-velocity/docs/index.html,v
  retrieving revision 1.13
  retrieving revision 1.14
  diff -u -r1.13 -r1.14
  --- index.html        2001/01/11 03:37:46     1.13
  +++ index.html        2001/02/12 20:03:27     1.14
  @@ -13,6 +13,7 @@
       <FONT face="arial,helvetica,sanserif" size="-1"><LI><A 
href="user-guide.html">User's Guide</A></LI></FONT>
       <FONT face="arial,helvetica,sanserif" size="-1"><LI><A 
href="developer-guide.html">Developer's Guide</A></LI></FONT>
       <FONT face="arial,helvetica,sanserif" size="-1"><LI><A 
href="vtl-reference-guide.html">VTL Reference Guide</A></LI></FONT>
  +    <FONT face="arial,helvetica,sanserif" size="-1"><LI><A 
href="differences.html">VM/WM Differences</A></LI></FONT>
   <P>Tools</P>
       <FONT face="arial,helvetica,sanserif" size="-1"><LI><A 
href="anakia.html">Anakia</A></LI></FONT>
       <FONT face="arial,helvetica,sanserif" size="-1"><LI><A 
href="texen.html">Texen</A></LI></FONT>
  @@ -98,6 +99,6 @@
   
    
    </TD></TR></TABLE></TD></TR></TABLE><BR><TABLE border="0" cellpadding="0" 
cellspacing="0" width="100%"><TR><TD bgcolor="#023264"><IMG height="1" 
src="resources/resources.gif" width="1"></TD></TR><TR><TD align="center"><FONT 
color="#023264" face="arial,helvetica,sanserif" size="-1"><I>
  -              Copyright &copy; 2000 The Apache Software Foundation.
  +              Copyright &copy; 2000-2001 The Apache Software Foundation.
                 All Rights Reserved.
               </I></FONT></TD></TR></TABLE></BODY></HTML>
  
  
  
  1.14      +2 -1      jakarta-velocity/docs/install.html
  
  Index: install.html
  ===================================================================
  RCS file: /home/cvs/jakarta-velocity/docs/install.html,v
  retrieving revision 1.13
  retrieving revision 1.14
  diff -u -r1.13 -r1.14
  --- install.html      2001/01/11 03:37:46     1.13
  +++ install.html      2001/02/12 20:03:28     1.14
  @@ -13,6 +13,7 @@
       <FONT face="arial,helvetica,sanserif" size="-1"><LI><A 
href="user-guide.html">User's Guide</A></LI></FONT>
       <FONT face="arial,helvetica,sanserif" size="-1"><LI><A 
href="developer-guide.html">Developer's Guide</A></LI></FONT>
       <FONT face="arial,helvetica,sanserif" size="-1"><LI><A 
href="vtl-reference-guide.html">VTL Reference Guide</A></LI></FONT>
  +    <FONT face="arial,helvetica,sanserif" size="-1"><LI><A 
href="differences.html">VM/WM Differences</A></LI></FONT>
   <P>Tools</P>
       <FONT face="arial,helvetica,sanserif" size="-1"><LI><A 
href="anakia.html">Anakia</A></LI></FONT>
       <FONT face="arial,helvetica,sanserif" size="-1"><LI><A 
href="texen.html">Texen</A></LI></FONT>
  @@ -82,6 +83,6 @@
   
   
   </TD></TR></TABLE></TD></TR></TABLE><BR><TABLE border="0" cellpadding="0" 
cellspacing="0" width="100%"><TR><TD bgcolor="#023264"><IMG height="1" 
src="resources/resources.gif" width="1"></TD></TR><TR><TD align="center"><FONT 
color="#023264" face="arial,helvetica,sanserif" size="-1"><I>
  -              Copyright &copy; 2000 The Apache Software Foundation.
  +              Copyright &copy; 2000-2001 The Apache Software Foundation.
                 All Rights Reserved.
               </I></FONT></TD></TR></TABLE></BODY></HTML>
  
  
  
  1.11      +2 -1      jakarta-velocity/docs/license.html
  
  Index: license.html
  ===================================================================
  RCS file: /home/cvs/jakarta-velocity/docs/license.html,v
  retrieving revision 1.10
  retrieving revision 1.11
  diff -u -r1.10 -r1.11
  --- license.html      2000/11/23 01:29:30     1.10
  +++ license.html      2001/02/12 20:03:28     1.11
  @@ -13,6 +13,7 @@
       <FONT face="arial,helvetica,sanserif" size="-1"><LI><A 
href="user-guide.html">User's Guide</A></LI></FONT>
       <FONT face="arial,helvetica,sanserif" size="-1"><LI><A 
href="developer-guide.html">Developer's Guide</A></LI></FONT>
       <FONT face="arial,helvetica,sanserif" size="-1"><LI><A 
href="vtl-reference-guide.html">VTL Reference Guide</A></LI></FONT>
  +    <FONT face="arial,helvetica,sanserif" size="-1"><LI><A 
href="differences.html">VM/WM Differences</A></LI></FONT>
   <P>Tools</P>
       <FONT face="arial,helvetica,sanserif" size="-1"><LI><A 
href="anakia.html">Anakia</A></LI></FONT>
       <FONT face="arial,helvetica,sanserif" size="-1"><LI><A 
href="texen.html">Texen</A></LI></FONT>
  @@ -87,6 +88,6 @@
   
   
   </TD></TR></TABLE></TD></TR></TABLE><BR><TABLE border="0" cellpadding="0" 
cellspacing="0" width="100%"><TR><TD bgcolor="#023264"><IMG height="1" 
src="resources/resources.gif" width="1"></TD></TR><TR><TD align="center"><FONT 
color="#023264" face="arial,helvetica,sanserif" size="-1"><I>
  -              Copyright &copy; 2000 The Apache Software Foundation.
  +              Copyright &copy; 2000-2001 The Apache Software Foundation.
                 All Rights Reserved.
               </I></FONT></TD></TR></TABLE></BODY></HTML>
  
  
  
  1.7       +2 -1      jakarta-velocity/docs/migration.html
  
  Index: migration.html
  ===================================================================
  RCS file: /home/cvs/jakarta-velocity/docs/migration.html,v
  retrieving revision 1.6
  retrieving revision 1.7
  diff -u -r1.6 -r1.7
  --- migration.html    2001/01/11 03:37:46     1.6
  +++ migration.html    2001/02/12 20:03:28     1.7
  @@ -13,6 +13,7 @@
       <FONT face="arial,helvetica,sanserif" size="-1"><LI><A 
href="user-guide.html">User's Guide</A></LI></FONT>
       <FONT face="arial,helvetica,sanserif" size="-1"><LI><A 
href="developer-guide.html">Developer's Guide</A></LI></FONT>
       <FONT face="arial,helvetica,sanserif" size="-1"><LI><A 
href="vtl-reference-guide.html">VTL Reference Guide</A></LI></FONT>
  +    <FONT face="arial,helvetica,sanserif" size="-1"><LI><A 
href="differences.html">VM/WM Differences</A></LI></FONT>
   <P>Tools</P>
       <FONT face="arial,helvetica,sanserif" size="-1"><LI><A 
href="anakia.html">Anakia</A></LI></FONT>
       <FONT face="arial,helvetica,sanserif" size="-1"><LI><A 
href="texen.html">Texen</A></LI></FONT>
  @@ -86,6 +87,6 @@
   
   
   </TD></TR></TABLE></TD></TR></TABLE><BR><TABLE border="0" cellpadding="0" 
cellspacing="0" width="100%"><TR><TD bgcolor="#023264"><IMG height="1" 
src="resources/resources.gif" width="1"></TD></TR><TR><TD align="center"><FONT 
color="#023264" face="arial,helvetica,sanserif" size="-1"><I>
  -              Copyright &copy; 2000 The Apache Software Foundation.
  +              Copyright &copy; 2000-2001 The Apache Software Foundation.
                 All Rights Reserved.
               </I></FONT></TD></TR></TABLE></BODY></HTML>
  
  
  
  1.5       +4 -3      jakarta-velocity/docs/texen.html
  
  Index: texen.html
  ===================================================================
  RCS file: /home/cvs/jakarta-velocity/docs/texen.html,v
  retrieving revision 1.4
  retrieving revision 1.5
  diff -u -r1.4 -r1.5
  --- texen.html        2001/01/11 03:37:47     1.4
  +++ texen.html        2001/02/12 20:03:29     1.5
  @@ -13,6 +13,7 @@
       <FONT face="arial,helvetica,sanserif" size="-1"><LI><A 
href="user-guide.html">User's Guide</A></LI></FONT>
       <FONT face="arial,helvetica,sanserif" size="-1"><LI><A 
href="developer-guide.html">Developer's Guide</A></LI></FONT>
       <FONT face="arial,helvetica,sanserif" size="-1"><LI><A 
href="vtl-reference-guide.html">VTL Reference Guide</A></LI></FONT>
  +    <FONT face="arial,helvetica,sanserif" size="-1"><LI><A 
href="differences.html">VM/WM Differences</A></LI></FONT>
   <P>Tools</P>
       <FONT face="arial,helvetica,sanserif" size="-1"><LI><A 
href="anakia.html">Anakia</A></LI></FONT>
       <FONT face="arial,helvetica,sanserif" size="-1"><LI><A 
href="texen.html">Texen</A></LI></FONT>
  @@ -104,7 +105,7 @@
   
   *#
   
  -#set $Planets = [&quot;Earth&quot;, &quot;Mars&quot;, &quot;Venus&quot;]
  +#set ($Planets = [&quot;Earth&quot;, &quot;Mars&quot;, &quot;Venus&quot;])
   
   #foreach ($planet in $Planets)
   
  @@ -130,7 +131,7 @@
   
   *#
   
  -#set $bgcolor = &quot;#ffffff&quot;
  +#set ($bgcolor = &quot;#ffffff&quot;)
   
   &lt;html&gt;
     &lt;head&gt;
  @@ -166,6 +167,6 @@
   
   
   </TD></TR></TABLE></TD></TR></TABLE><BR><TABLE border="0" cellpadding="0" 
cellspacing="0" width="100%"><TR><TD bgcolor="#023264"><IMG height="1" 
src="resources/resources.gif" width="1"></TD></TR><TR><TD align="center"><FONT 
color="#023264" face="arial,helvetica,sanserif" size="-1"><I>
  -              Copyright &copy; 2000 The Apache Software Foundation.
  +              Copyright &copy; 2000-2001 The Apache Software Foundation.
                 All Rights Reserved.
               </I></FONT></TD></TR></TABLE></BODY></HTML>
  
  
  
  1.12      +2 -1      jakarta-velocity/docs/todo.html
  
  Index: todo.html
  ===================================================================
  RCS file: /home/cvs/jakarta-velocity/docs/todo.html,v
  retrieving revision 1.11
  retrieving revision 1.12
  diff -u -r1.11 -r1.12
  --- todo.html 2000/11/23 01:29:30     1.11
  +++ todo.html 2001/02/12 20:03:29     1.12
  @@ -13,6 +13,7 @@
       <FONT face="arial,helvetica,sanserif" size="-1"><LI><A 
href="user-guide.html">User's Guide</A></LI></FONT>
       <FONT face="arial,helvetica,sanserif" size="-1"><LI><A 
href="developer-guide.html">Developer's Guide</A></LI></FONT>
       <FONT face="arial,helvetica,sanserif" size="-1"><LI><A 
href="vtl-reference-guide.html">VTL Reference Guide</A></LI></FONT>
  +    <FONT face="arial,helvetica,sanserif" size="-1"><LI><A 
href="differences.html">VM/WM Differences</A></LI></FONT>
   <P>Tools</P>
       <FONT face="arial,helvetica,sanserif" size="-1"><LI><A 
href="anakia.html">Anakia</A></LI></FONT>
       <FONT face="arial,helvetica,sanserif" size="-1"><LI><A 
href="texen.html">Texen</A></LI></FONT>
  @@ -221,6 +222,6 @@
   
   
   </TD></TR></TABLE></TD></TR></TABLE><BR><TABLE border="0" cellpadding="0" 
cellspacing="0" width="100%"><TR><TD bgcolor="#023264"><IMG height="1" 
src="resources/resources.gif" width="1"></TD></TR><TR><TD align="center"><FONT 
color="#023264" face="arial,helvetica,sanserif" size="-1"><I>
  -              Copyright &copy; 2000 The Apache Software Foundation.
  +              Copyright &copy; 2000-2001 The Apache Software Foundation.
                 All Rights Reserved.
               </I></FONT></TD></TR></TABLE></BODY></HTML>
  
  
  
  1.15      +2 -1      jakarta-velocity/docs/user-guide.html
  
  Index: user-guide.html
  ===================================================================
  RCS file: /home/cvs/jakarta-velocity/docs/user-guide.html,v
  retrieving revision 1.14
  retrieving revision 1.15
  diff -u -r1.14 -r1.15
  --- user-guide.html   2001/02/09 03:51:39     1.14
  +++ user-guide.html   2001/02/12 20:03:30     1.15
  @@ -13,6 +13,7 @@
       <FONT face="arial,helvetica,sanserif" size="-1"><LI><A 
href="user-guide.html">User's Guide</A></LI></FONT>
       <FONT face="arial,helvetica,sanserif" size="-1"><LI><A 
href="developer-guide.html">Developer's Guide</A></LI></FONT>
       <FONT face="arial,helvetica,sanserif" size="-1"><LI><A 
href="vtl-reference-guide.html">VTL Reference Guide</A></LI></FONT>
  +    <FONT face="arial,helvetica,sanserif" size="-1"><LI><A 
href="differences.html">VM/WM Differences</A></LI></FONT>
   <P>Tools</P>
       <FONT face="arial,helvetica,sanserif" size="-1"><LI><A 
href="anakia.html">Anakia</A></LI></FONT>
       <FONT face="arial,helvetica,sanserif" size="-1"><LI><A 
href="texen.html">Texen</A></LI></FONT>
  @@ -1663,6 +1664,6 @@
   
   
   </TD></TR></TABLE></TD></TR></TABLE><BR><TABLE border="0" cellpadding="0" 
cellspacing="0" width="100%"><TR><TD bgcolor="#023264"><IMG height="1" 
src="resources/resources.gif" width="1"></TD></TR><TR><TD align="center"><FONT 
color="#023264" face="arial,helvetica,sanserif" size="-1"><I>
  -              Copyright &copy; 2000 The Apache Software Foundation.
  +              Copyright &copy; 2000-2001 The Apache Software Foundation.
                 All Rights Reserved.
               </I></FONT></TD></TR></TABLE></BODY></HTML>
  
  
  
  1.14      +2 -1      jakarta-velocity/docs/vtl-reference-guide.html
  
  Index: vtl-reference-guide.html
  ===================================================================
  RCS file: /home/cvs/jakarta-velocity/docs/vtl-reference-guide.html,v
  retrieving revision 1.13
  retrieving revision 1.14
  diff -u -r1.13 -r1.14
  --- vtl-reference-guide.html  2001/02/09 03:51:39     1.13
  +++ vtl-reference-guide.html  2001/02/12 20:03:31     1.14
  @@ -13,6 +13,7 @@
       <FONT face="arial,helvetica,sanserif" size="-1"><LI><A 
href="user-guide.html">User's Guide</A></LI></FONT>
       <FONT face="arial,helvetica,sanserif" size="-1"><LI><A 
href="developer-guide.html">Developer's Guide</A></LI></FONT>
       <FONT face="arial,helvetica,sanserif" size="-1"><LI><A 
href="vtl-reference-guide.html">VTL Reference Guide</A></LI></FONT>
  +    <FONT face="arial,helvetica,sanserif" size="-1"><LI><A 
href="differences.html">VM/WM Differences</A></LI></FONT>
   <P>Tools</P>
       <FONT face="arial,helvetica,sanserif" size="-1"><LI><A 
href="anakia.html">Anakia</A></LI></FONT>
       <FONT face="arial,helvetica,sanserif" size="-1"><LI><A 
href="texen.html">Texen</A></LI></FONT>
  @@ -245,6 +246,6 @@
   
   
   </TD></TR></TABLE></TD></TR></TABLE><BR><TABLE border="0" cellpadding="0" 
cellspacing="0" width="100%"><TR><TD bgcolor="#023264"><IMG height="1" 
src="resources/resources.gif" width="1"></TD></TR><TR><TD align="center"><FONT 
color="#023264" face="arial,helvetica,sanserif" size="-1"><I>
  -              Copyright &copy; 2000 The Apache Software Foundation.
  +              Copyright &copy; 2000-2001 The Apache Software Foundation.
                 All Rights Reserved.
               </I></FONT></TD></TR></TABLE></BODY></HTML>
  
  
  
  1.1                  jakarta-velocity/docs/differences.html
  
  Index: differences.html
  ===================================================================
  <HTML><HEAD><TITLE>Differences: Velocity vs. WebMacro</TITLE></HEAD><BODY 
alink="#023264" bgcolor="#ffffff" leftmargin="4" link="#023264" marginheight="4" 
marginwidth="4" text="#000000" topmargin="4" vlink="#023264"><TABLE border="0" 
cellpadding="0" cellspacing="0" width="100%"><TR><TD align="left" valign="top"><A 
href="http://jakarta.apache.org/index.html"><IMG border="0" hspace="0" 
src="resources/jakarta-logo.gif" vspace="0"></A></TD><TD align="left" 
bgcolor="#ffffff" valign="top" width="100%"><IMG align="right" alt="" border="0" 
hspace="0" src="resources/header.gif" vspace="0"></TD></TR><TR><TD><IMG border="0" 
height="5" hspace="0" src="resources/void.gif" vspace="0" width="5"></TD></TR><TR><TD 
background="resources/line.gif" colspan="2" height="2" width="100%"><IMG alt="" 
border="0" height="2" hspace="0" src="resources/line.gif" vspace="0" 
width="1"></TD></TR></TABLE><TABLE border="0" cellpadding="0" cellspacing="0" 
width="100%"><TR><TD valign="top" width="1%"></TD><TD nowrap="1" valign="top" 
width="14%"><BR>
  
  <P>About</P>
      <FONT face="arial,helvetica,sanserif" size="-1"><LI><A 
href="index.html">Overview</A></LI></FONT>
      <FONT face="arial,helvetica,sanserif" size="-1"><LI><A 
href="getting-started.html">Getting Started</A></LI></FONT>
      <FONT face="arial,helvetica,sanserif" size="-1"><LI><A 
href="install.html">Install</A></LI></FONT>
      <FONT face="arial,helvetica,sanserif" size="-1"><LI><A 
href="design.html">Design</A></LI></FONT>
      <FONT face="arial,helvetica,sanserif" size="-1"><LI><A 
href="contributors.html">Contributors</A></LI></FONT>
      <FONT face="arial,helvetica,sanserif" size="-1"><LI><A 
href="code-standards.html">Coding Standards</A></LI></FONT>
      <FONT face="arial,helvetica,sanserif" size="-1"><LI><A 
href="license.html">License</A></LI></FONT>
      <FONT face="arial,helvetica,sanserif" size="-1"><LI><A 
href="todo.html">TODO</A></LI></FONT>
  <P>Guides</P>
      <FONT face="arial,helvetica,sanserif" size="-1"><LI><A 
href="user-guide.html">User's Guide</A></LI></FONT>
      <FONT face="arial,helvetica,sanserif" size="-1"><LI><A 
href="developer-guide.html">Developer's Guide</A></LI></FONT>
      <FONT face="arial,helvetica,sanserif" size="-1"><LI><A 
href="vtl-reference-guide.html">VTL Reference Guide</A></LI></FONT>
      <FONT face="arial,helvetica,sanserif" size="-1"><LI><A 
href="differences.html">VM/WM Differences</A></LI></FONT>
  <P>Tools</P>
      <FONT face="arial,helvetica,sanserif" size="-1"><LI><A 
href="anakia.html">Anakia</A></LI></FONT>
      <FONT face="arial,helvetica,sanserif" size="-1"><LI><A 
href="texen.html">Texen</A></LI></FONT>
      <FONT face="arial,helvetica,sanserif" size="-1"><LI><A 
href="migration.html">Migration To Velocity</A></LI></FONT>
  </TD><TD align="left" valign="top" width="*"><TABLE border="0" cellpadding="3" 
cellspacing="0"><TR><TD><BR>
  
   
  
   
  
   <DIV align="right"><TABLE border="0" cellpadding="0" cellspacing="0" 
width="98%"><TR><TD bgcolor="#023264" width="100%"><FONT color="#ffffff" 
face="arial,helvetica,sanserif" size="+1"><IMG border="0" height="5" hspace="0" 
src="resources/void.gif" vspace="0" width="5"><B>Differences: Velocity vs. 
WebMacro</B></FONT></TD></TR><TR><TD><IMG border="0" height="5" hspace="0" 
src="resources/void.gif" vspace="0" width="1"></TD></TR></TABLE><TABLE border="0" 
cellpadding="0" cellspacing="0" width="98%"><TR><TD><FONT color="#000000" 
face="arial,helvetica,sanserif">
  
   <P align="justify">
  On the mailing lists, we often get asked to explain the differences
  between Velocity and WebMacro. Instead of answering the same question
  over and over, we have started this document to describe some of the
  differences in our approaches. In reality, both are excellent tools and
  we feel that it is up to the user base to decide which one they would
  like to use.
   </P>
  
   <P align="justify">
  The language syntax is very close but not exactly the same. The syntaxes
  were kept close for a few reasons:
   </P>
  
   <P align="justify">
  1) The syntactical approach of $&lt;foo&gt; for references and
  #&lt;bar&gt; for directives is a good one! It's easy for designers to
  work with, people understand it, and there was no reason to reinvent the
  wheel.
   </P>
  
   <P align="justify">
  2) Since so many people were using the syntax, why invent another one?
  Also, it makes the WebMacro to Velocity conversion much easier :) We
  even have a <A href="migration.html">tool</A> to help with that.
   </P>
  
   <P align="justify">
  Velocity was built new from the ground up.  There isn't a snippet of
  shared code. This was originally done because WebMacro was released
  under a license (GPL) that is not compatible with the BSD/ASF license
  and we (the original authors) needed a solution that was not under a GPL
  license. Since then, WebMacro has been released under a dual GPL/ASF
  license, however, that was too late, this project was already well
  underway and we also felt that we have a better technical solution by
  going with a generated parser instead of a hand coded one.
   </P>
  
  <P align="justify">
  By starting new and fresh, we are less encumbered with some of the
  baggage that WebMacro must deal with due to backwards compatibility
  issues. We have fixed a few of the template language inconsistencies
  that we saw creeping into WebMacro such as the fact that we do not
  support using {} for code blocks (because we do not need to) and that we
  use () around all #directives on the right hand side. Examples:
  </P>
  
  <DIV align="center"><TABLE border="0" cellpadding="0" cellspacing="4"><TR><TD 
bgcolor="#023264" height="1" width="1"><IMG border="0" height="1" hspace="0" 
src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#023264" 
height="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" 
width="1"></TD><TD bgcolor="#023264" height="1" width="1"><IMG border="0" height="1" 
hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR><TR><TD 
bgcolor="#023264" width="1"><IMG border="0" height="1" hspace="0" 
src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#ffffff"><PRE>#set 
($bar = &quot;foo&quot;)
  
  #if ($bar.length() &gt; 0)
  stuff here
  #end</PRE></TD><TD bgcolor="#023264" width="1"><IMG border="0" height="1" hspace="0" 
src="resources/void.gif" vspace="0" width="1"></TD></TR><TR><TD bgcolor="#023264" 
height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" 
vspace="0" width="1"></TD><TD bgcolor="#023264" height="1"><IMG border="0" height="1" 
hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#023264" 
height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" 
vspace="0" width="1"></TD></TR></TABLE></DIV>
  
   <P align="justify">
  Architecturally, the biggest difference until recently was the parser.
  The Velocity parser is written using a tool called javacc, a very
  popular Java-based parser generator.  It was originally developed for
  Sun by Metamata and is now maintained and managed by Metamata as well :
  <A href="http://www.metamata.com/">www.metamata.com</A>.
   </P>
  
   <P align="justify">
  The WebMacro parser was written by hand until recently and was the cause
  of much pain when using WebMacro (due to many bugs in it) - their new
  parser, for their 0.95 release is also written using javacc and promises
  to be better (however, support for a lot of the baggage still exists).
   </P>
  
   <P align="justify">
  Velocity is very simple in its architecture, as it is meant to be
  nothing more than a template engine. The idea is to do one thing only
  and do it well.  Much in the spirit of the Unix philosophy - have a good
  set of simple tools, and create bigger things using them. This has
  enabled Velocity to be used as the basis for several different tools,
  such as <A href="anakia.html">Anakia</A> and <A href="texen.html">Texen</A>.
  </P>
  
   <P align="justify">
  Velocity is recognized that it isn't going to try to be a 'development
  framework' - there are plenty around, such as <A 
href="http://jakarta.apache.org/turbine/">Turbine</A>.
   </P>
  
   <P align="justify">
  Therefore, all facilities like 'context tool' and 'resource brokers' are
  purposely left out of Velocity, acknowledging that not only will
  frameworks do it, they will do it better anyway.  Further, by leaving out
  of the Velocity core much that should be done at the application / user
  / framework level, the Velocity core remains smaller and therefore, in
  our opinion, more maintainable and extensible.
   </P>
  
   <P align="justify">
  Internally, Velocity is pretty straightforward.  There are no threads
  created or managed for you.  Templates are parsed and caches, kept in
  their internal form of an 'Abstract Syntax Tree', a tree structure that
  is then rapidly walked when your template is merged.  Each node
  corresponds to on of the syntactical elements in your template.
   </P>
  
  <P align="justify">
  Internally within WebMacro, many of the methods and classes are marked
  as private and/or final in order to achieve better speed. However, this
  has prevented people from easily extending or overriding some of the
  core funtionality and re-using some of the code. We would rather
  sacrifice a few ms in favor of allowing more people to use our software
  easily.
  </P>
  
   <P align="justify">
  The biggest feature difference between the two are the '<A 
href="user-guide.html">Velocimacros</A>'. Velocimacros can be thought of
  as snippets of re-usable data that can contain anything. They are parsed
  just like the data in a #parse() statement would be and you can pass in
  variables that can optionally have scope only within the Velocimacro.
   </P>
  
  <P align="justify">
  Velocimacro's are also helping keep the core #directive set small and
  clean. In other words, WebMacro is adding #directives to the core at an
  increasing rate and we are not. We would rather support optional
  downloads for that &quot;extra&quot; funtionality that can be shared.
  </P>
  
   <P align="justify">
  We hope this helps.  The best way to understand Velocity is to use it,
  and of course nothing beats looking at the source code.
   </P> 
  
   </FONT></TD></TR></TABLE></DIV><BR>
  
   
   </TD></TR></TABLE></TD></TR></TABLE><BR><TABLE border="0" cellpadding="0" 
cellspacing="0" width="100%"><TR><TD bgcolor="#023264"><IMG height="1" 
src="resources/resources.gif" width="1"></TD></TR><TR><TD align="center"><FONT 
color="#023264" face="arial,helvetica,sanserif" size="-1"><I>
                Copyright &copy; 2000-2001 The Apache Software Foundation.
                All Rights Reserved.
              </I></FONT></TD></TR></TABLE></BODY></HTML>
  
  
  1.9       +2 -1      jakarta-velocity/xdocs/site-book.xml
  
  Index: site-book.xml
  ===================================================================
  RCS file: /home/cvs/jakarta-velocity/xdocs/site-book.xml,v
  retrieving revision 1.8
  retrieving revision 1.9
  diff -u -r1.8 -r1.9
  --- site-book.xml     2000/11/23 01:28:53     1.8
  +++ site-book.xml     2001/02/12 20:03:38     1.9
  @@ -1,6 +1,6 @@
   <?xml version="1.0"?>
   
  -<book title="Velocity Documentation" copyright="2000 The Apache Software 
Foundation">
  +<book title="Velocity Documentation" copyright="2000-2001 The Apache Software 
Foundation">
   
   <section label="About"/>
       <page id="index" label="Overview" source="index.xml"/>
  @@ -15,6 +15,7 @@
       <page id="user-guide" label="User's Guide" source="user-guide.xml"/>
       <page id="developer-guide" label="Developer's Guide" 
source="developer-guide.xml"/>
       <page id="vtl-reference-guide" label="VTL Reference Guide" 
source="vtl-reference-guide.xml"/>
  +    <page id="differences" label="VM/WM Differences" source="differences.xml"/>
   <section label="Tools"/>
       <page id="anakia" label="Anakia" source="anakia.xml"/>
       <page id="texen" label="Texen" source="texen.xml"/>
  
  
  
  1.3       +2 -2      jakarta-velocity/xdocs/texen.xml
  
  Index: texen.xml
  ===================================================================
  RCS file: /home/cvs/jakarta-velocity/xdocs/texen.xml,v
  retrieving revision 1.2
  retrieving revision 1.3
  diff -u -r1.2 -r1.3
  --- texen.xml 2000/12/12 05:08:06     1.2
  +++ texen.xml 2001/02/12 20:03:39     1.3
  @@ -93,7 +93,7 @@
   
   *#
   
  -#set $Planets = ["Earth", "Mars", "Venus"]
  +#set ($Planets = ["Earth", "Mars", "Venus"])
   
   #foreach ($planet in $Planets)
   
  @@ -119,7 +119,7 @@
   
   *#
   
  -#set $bgcolor = "#ffffff"
  +#set ($bgcolor = "#ffffff")
   
   <html>
     <head>
  
  
  
  1.1                  jakarta-velocity/xdocs/differences.xml
  
  Index: differences.xml
  ===================================================================
  <?xml version="1.0"?>
  
  <document>
  
   <header>
    <title>Differences: Velocity vs. WebMacro</title>
    <subtitle>Differences: Velocity vs. WebMacro</subtitle>
    <authors>
     <person name="Velocity Documentation Team" email="[EMAIL PROTECTED]"/>
     <person name="Velocity Documentation Team" email="[EMAIL PROTECTED]"/>
    </authors>
   </header>
  
   <body>
  
   <s1 title="Differences: Velocity vs. WebMacro">
  
   <p>
  On the mailing lists, we often get asked to explain the differences
  between Velocity and WebMacro. Instead of answering the same question
  over and over, we have started this document to describe some of the
  differences in our approaches. In reality, both are excellent tools and
  we feel that it is up to the user base to decide which one they would
  like to use.
   </p>
  
   <p>
  The language syntax is very close but not exactly the same. The syntaxes
  were kept close for a few reasons:
   </p>
  
   <p>
  1) The syntactical approach of $&lt;foo&gt; for references and
  #&lt;bar&gt; for directives is a good one! It's easy for designers to
  work with, people understand it, and there was no reason to reinvent the
  wheel.
   </p>
  
   <p>
  2) Since so many people were using the syntax, why invent another one?
  Also, it makes the WebMacro to Velocity conversion much easier :) We
  even have a <link href="migration.html">tool</link> to help with that.
   </p>
  
   <p>
  Velocity was built new from the ground up.  There isn't a snippet of
  shared code. This was originally done because WebMacro was released
  under a license (GPL) that is not compatible with the BSD/ASF license
  and we (the original authors) needed a solution that was not under a GPL
  license. Since then, WebMacro has been released under a dual GPL/ASF
  license, however, that was too late, this project was already well
  underway and we also felt that we have a better technical solution by
  going with a generated parser instead of a hand coded one.
   </p>
  
  <p>
  By starting new and fresh, we are less encumbered with some of the
  baggage that WebMacro must deal with due to backwards compatibility
  issues. We have fixed a few of the template language inconsistencies
  that we saw creeping into WebMacro such as the fact that we do not
  support using {} for code blocks (because we do not need to) and that we
  use () around all #directives on the right hand side. Examples:
  </p>
  
  <source><![CDATA[#set ($bar = "foo")
  
  #if ($bar.length() > 0)
  stuff here
  #end]]></source>
  
   <p>
  Architecturally, the biggest difference until recently was the parser.
  The Velocity parser is written using a tool called javacc, a very
  popular Java-based parser generator.  It was originally developed for
  Sun by Metamata and is now maintained and managed by Metamata as well :
  <link href="http://www.metamata.com/">www.metamata.com</link>.
   </p>
  
   <p>
  The WebMacro parser was written by hand until recently and was the cause
  of much pain when using WebMacro (due to many bugs in it) - their new
  parser, for their 0.95 release is also written using javacc and promises
  to be better (however, support for a lot of the baggage still exists).
   </p>
  
   <p>
  Velocity is very simple in its architecture, as it is meant to be
  nothing more than a template engine. The idea is to do one thing only
  and do it well.  Much in the spirit of the Unix philosophy - have a good
  set of simple tools, and create bigger things using them. This has
  enabled Velocity to be used as the basis for several different tools,
  such as <link href="anakia.html">Anakia</link> and <link
  href="texen.html">Texen</link>.
  </p>
  
   <p>
  Velocity is recognized that it isn't going to try to be a 'development
  framework' - there are plenty around, such as <link
  href="http://jakarta.apache.org/turbine/">Turbine</link>.
   </p>
  
   <p>
  Therefore, all facilities like 'context tool' and 'resource brokers' are
  purposely left out of Velocity, acknowledging that not only will
  frameworks do it, they will do it better anyway.  Further, by leaving out
  of the Velocity core much that should be done at the application / user
  / framework level, the Velocity core remains smaller and therefore, in
  our opinion, more maintainable and extensible.
   </p>
  
   <p>
  Internally, Velocity is pretty straightforward.  There are no threads
  created or managed for you.  Templates are parsed and caches, kept in
  their internal form of an 'Abstract Syntax Tree', a tree structure that
  is then rapidly walked when your template is merged.  Each node
  corresponds to on of the syntactical elements in your template.
   </p>
  
  <p>
  Internally within WebMacro, many of the methods and classes are marked
  as private and/or final in order to achieve better speed. However, this
  has prevented people from easily extending or overriding some of the
  core funtionality and re-using some of the code. We would rather
  sacrifice a few ms in favor of allowing more people to use our software
  easily.
  </p>
  
   <p>
  The biggest feature difference between the two are the '<link
  href="user-guide.html">Velocimacros</link>'. Velocimacros can be thought of
  as snippets of re-usable data that can contain anything. They are parsed
  just like the data in a #parse() statement would be and you can pass in
  variables that can optionally have scope only within the Velocimacro.
   </p>
  
  <p>
  Velocimacro's are also helping keep the core #directive set small and
  clean. In other words, WebMacro is adding #directives to the core at an
  increasing rate and we are not. We would rather support optional
  downloads for that "extra" funtionality that can be shared.
  </p>
  
   <p>
  We hope this helps.  The best way to understand Velocity is to use it,
  and of course nothing beats looking at the source code.
   </p> 
  
   </s1>
  
   </body>
   </document>
  
  
  

Reply via email to