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:
parent
706fcec164
commit
1147a57d20
|
@ -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``::
|
||||||
|
|
Loading…
Reference in New Issue