--- trunk2/NEWS.pod	2004/06/20 15:49:09	373
+++ trunk2/NEWS.pod	2004/09/15 22:36:23	454
@@ -2,7 +2,7 @@
 
 Quick overview of things that are new in v2.x of WebPAC
 
-=head1 DESCRIPTION
+=head1 Changes from version 1
 
 This document will describe new features in WebPAC version v2.x.
 It will also attempt to document upgrade procedure to migrate
@@ -64,3 +64,43 @@
 
 For you, the user, that will result in changes to all templates. I'm sorry
 about this, but it had to be done.
+
+=head2 Order of substitution
+
+This was never really documented, so here it is now:
+
+=over 5
+
+=item fields
+
+substitution of fields like C<v200^a> into values
+
+=item lookups
+
+next, lookups are performed (C<lookup{...}>)
+
+=item format
+
+then formats (defined by C<format_name=> and C<format_delimiter=>) are
+applied. If formats have lookups, they will be performed again.
+
+=head1 New features of version 2
+
+Here are new features which didn't exist in version 1.
+
+=head2 Documentation
+
+Code is well documented using C<pod>.
+
+=head2 Baking as opposed to cooking your WebPAC
+
+It's possible to create searchable WebPAC completely static, from HTML and
+JavaScript, so you can burn it on CD-ROM.
+
+This was original reason for writing version 2 in the first place.
+
+=head2 Tree structures for data display
+
+See L<WebPAC::Tree>.
+
+=cut