Final changes for Jinja 2.1 release
[jinja2.git] / CHANGES
diff --git a/CHANGES b/CHANGES
index 08b316f3d6dab696e1aafa71a5aa5e45f2fb2e11..bcf38d2b7a35400a9d13205a3a072cfbd43f6295 100644 (file)
--- a/CHANGES
+++ b/CHANGES
@@ -1,54 +1,84 @@
-Jinja Changelog
+Jinja2 Changelog
 ===============
 
-Version 1.1
+Version 2.1
 -----------
-(codename to be selected, release date unknown)
+(codename Yasuzō, released on November 23rd 2008)
 
-- blocks now support ``{{ super() }}`` to render the parent output.
+- fixed a bug with nested loops and the special loop variable.  Before the
+  change an inner loop overwrote the loop variable from the outer one after
+  iteration.
 
-- debugging system improved, smaller filesize for the cached files.
-  Debugging works now well for any module using linecache.
+- fixed a bug with the i18n extension that caused the explicit pluralization
+  block to look up the wrong variable.
 
-- ``{{ debug() }}`` can now be used to get a list of filters and
-  tags.
+- fixed a limitation in the lexer that made ``{{ foo.0.0 }}`` impossible.
 
-- added whitespace management system for the template designer.
+- index based subscribing of variables with a constant value returns an
+  undefined object now instead of raising an index error.  This was a bug
+  caused by eager optimizing.
 
-- some small bugfixes.
+- the i18n extension looks up `foo.ugettext` now followed by `foo.gettext`
+  if an translations object is installed.  This makes dealing with custom
+  translations classes easier.
 
-- improved security system regarding function calls.
+- fixed a confusing behavior with conditional extending.  loops were partially
+  executed under some conditions even though they were not part of a visible
+  area.
 
-- added `lipsum` function to generate random text.
+- added `sort` filter that works like `dictsort` but for arbitrary sequences.
 
-- strings without unicode characters are processed as binary strings now
-  to workaround problems with `datetime.strftime` which only accepts
-  binary strings.
+- fixed a bug with empty statements in macros.
 
-- developer friendly traceback is now toggleable
+- implemented a bytecode cache system.  (:ref:`bytecode-cache`)
 
-- silent variable name failure is now toggleable
+- the template context is now weakref-able
 
-- fixed issue with old-style classes not implementing `__getitem__`
-  (thanks to Axel Böhm for discovering that bug)
+- inclusions and imports "with context" forward all variables now, not only
+  the initial context.
 
-- added a bunch of new docstrings to the Jinja classes. Makes fun now to
-  use pydoc :-)
+- added a cycle helper called `cycler`.
 
-- fixed severe memcaching bug. Formerly it wasn't possible to use memcaching
-  without enabling disk cache.
+- added a joining helper called `joiner`.
 
-- fixed a bug that allowed users to override the special names `_`, `true` etc.
+- added a `compile_expression` method to the environment that allows compiling
+  of Jinja expressions into callable Python objects.
 
-- added `batch` and `slice` filters for batching or slicing sequences
+- fixed an escaping bug in urlize
 
-- added `sum`, `abs` and `round` filters. This fixes #238
+Version 2.0
+-----------
+(codename jinjavitus, released on July 17th 2008)
 
-- added `striptags` and `xmlattr` filters for easier SGML/XML processing
+- the subscribing of objects (looking up attributes and items) changed from
+  slightly.  It's now possible to give attributes or items a higher priority
+  by either using dot-notation lookup or the bracket syntax.  This also
+  changed the AST slightly.  `Subscript` is gone and was replaced with
+  :class:`~jinja2.nodes.Getitem` and :class:`~jinja2.nodes.Getattr`.
 
+  For more information see :ref:`the implementation details <notes-on-subscriptions>`.
 
-Version 1.0
------------
-(released Mar 23, 2007)
+- added support for preprocessing and token stream filtering for extensions.
+  This would allow extensions to allow simplified gettext calls in template
+  data and something similar.
+
+- added :meth:`jinja2.environment.TemplateStream.dump`.
+
+- added missing support for implicit string literal concatenation.
+  ``{{ "foo" "bar" }}`` is equivalent to ``{{ "foobar" }}``
+
+- `else` is optional for conditional expressions.  If not given it evaluates
+  to `false`.
+
+- improved error reporting for undefined values by providing a position.
+
+- `filesizeformat` filter uses decimal prefixes now per default and can be
+  set to binary mode with the second parameter.
+
+- fixed bug in finalizer
+
+Version 2.0rc1
+--------------
+(no codename, released on June 9th 2008)
 
-- Initial release
+- first release of Jinja2