test0908
/
django
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity

Some final clarifications in the release notes. 

git-svn-id: http://code.djangoproject.com/svn/django/trunk@13273 bcc190cf-cafb-0310-a4f2-bffc1f526a37
This commit is contained in:
James Bennett 2010-05-17 16:47:16 +00:00
parent 47e3cc74d9
commit d88d0ec336
1 changed files with 17 additions and 12 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

29
docs/releases/1.2.txt
View File

@ -62,7 +62,7 @@ backwards-incompatible. The big changes are:
* The new CSRF protection framework is not backwards-compatible with * The new CSRF protection framework is not backwards-compatible with
the old system. Users of the old system will not be affected until the old system. Users of the old system will not be affected until
the old system is removed in Django 1.4 the old system is removed in Django 1.4.
However, upgrading to the new CSRF protection framework requires a few However, upgrading to the new CSRF protection framework requires a few
important backwards-incompatible changes, detailed in `CSRF Protection`_, important backwards-incompatible changes, detailed in `CSRF Protection`_,
@ -366,10 +366,13 @@ Backwards-incompatible changes in 1.2
Wherever possible the new features above have been introduced in a Wherever possible the new features above have been introduced in a
backwards-compatible manner per :ref:`our API stability policy backwards-compatible manner per :ref:`our API stability policy
<misc-api-stability>` policy. <misc-api-stability>` policy. This means that existing code which
worked with Django 1.1 will continue to work with Django 1.2; such
code will, however, begin issuing warnings (see below for details).
However, a handful of features *have* changed in ways that, for some users, will be However, a handful of features *have* changed in ways that, for some
backwards-incompatible. Those changes are detailed below. users, will be backwards-incompatible. Those changes are detailed
below.
CSRF Protection CSRF Protection
--------------- ---------------
@ -468,8 +471,9 @@ Stateful template tags
---------------------- ----------------------
Template tags that store rendering state on their ``Node`` subclass Template tags that store rendering state on their ``Node`` subclass
may experience problems if they are used with the new :ref:`cached have always been vulnerable to thread-safety and other issues; as of
template loader<template-loaders>`. Django 1.2, however, they may also cause problems when used with the
new :ref:`cached template loader<template-loaders>`.
All of the built-in Django template tags are safe to use with the cached All of the built-in Django template tags are safe to use with the cached
loader, but if you're using custom template tags that come from third loader, but if you're using custom template tags that come from third
@ -693,15 +697,16 @@ Finally, Django 1.2 deprecates some features from earlier releases.
These features are still supported, but will be gradually phased out These features are still supported, but will be gradually phased out
over the next few release cycles. over the next few release cycles.
Code take advantage of any of the features below will raise a Code taking advantage of any of the features below will raise a
``PendingDeprecationWarning`` in Django 1.2. This warning will be silent by ``PendingDeprecationWarning`` in Django 1.2. This warning will be
default, but may be turned on using Python's `warnings module`_, or by running silent by default, but may be turned on using Python's `warnings
Python with a ``-Wd`` or `-Wall` flag. module`_, or by running Python with a ``-Wd`` or `-Wall` flag.
.. _warnings module: http://docs.python.org/library/warnings.html .. _warnings module: http://docs.python.org/library/warnings.html
In Django 1.3, these warnings will become a ``DeprecationWarning``, which is *not* silent. In Django 1.4 In Django 1.3, these warnings will become a ``DeprecationWarning``,
support for these features will be removed entirely. which is *not* silent. In Django 1.4 support for these features will
be removed entirely.
.. seealso:: .. seealso::