Clarified docs/newforms.txt 'Migration plan' section

git-svn-id: http://code.djangoproject.com/svn/django/trunk@4209 bcc190cf-cafb-0310-a4f2-bffc1f526a37
This commit is contained in:
Adrian Holovaty 2006-12-15 18:07:20 +00:00
parent 706fcec164
commit 1147a57d20
1 changed files with 10 additions and 5 deletions

View File

@ -13,18 +13,23 @@ Migration plan
-- i.e., it's not available in the Django 0.95 release. For the next Django -- i.e., it's not available in the Django 0.95 release. For the next Django
release, our plan is to do the following: release, our plan is to do the following:
* Move the current ``django.forms`` to ``django.oldforms``. This will allow * As of revision [4208], we've copied the current ``django.forms`` to
for an eased migration of form code. You'll just have to change your ``django.oldforms``. This allows you to upgrade your code *now* rather
import statements:: than waiting for the backwards-incompatible change and rushing to fix
your code after the fact. Just change your import statements like this::
from django import forms # old from django import forms # old
from django import oldforms as forms # new from django import oldforms as forms # new
* Move the current ``django.newforms`` to ``django.forms``. * At an undecided future date, we will move the current ``django.newforms``
to ``django.forms``. This will be a backwards-incompatible change, and
anybody who is still using the old version of ``django.forms`` at that
time will need to change their import statements, as described in the
previous bullet.
* We will remove ``django.oldforms`` in the release *after* the next Django * We will remove ``django.oldforms`` in the release *after* the next Django
release -- the release that comes after the release in which we're release -- the release that comes after the release in which we're
creating ``django.oldforms``. creating the new ``django.forms``.
With this in mind, we recommend you use the following import statement when With this in mind, we recommend you use the following import statement when
using ``django.newforms``:: using ``django.newforms``::