Small tweak to docs/newforms.txt

git-svn-id: http://code.djangoproject.com/svn/django/trunk@4171 bcc190cf-cafb-0310-a4f2-bffc1f526a37
This commit is contained in:
Adrian Holovaty 2006-12-07 04:59:36 +00:00
parent b6a7afd4bd
commit 9a02d668c1
1 changed files with 7 additions and 6 deletions

View File

@ -3,10 +3,8 @@ The newforms library
==================== ====================
``django.newforms`` is a new replacement for ``django.forms``, the old Django ``django.newforms`` is a new replacement for ``django.forms``, the old Django
form/manipulator/validation framework. This functionality is new in the Django form/manipulator/validation framework. This document explains how to use this
development version -- i.e., it's not available in the Django 0.95 release. new form library.
This document explains how to use this new form library.
Migration plan Migration plan
============== ==============
@ -25,7 +23,7 @@ release, our plan is to do the following:
* Move the current ``django.newforms`` to ``django.forms``. * Move the current ``django.newforms`` to ``django.forms``.
* 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 -- i.e., 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 ``django.oldforms``.
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
@ -55,9 +53,12 @@ want to perform server-side validation for an HTML form.
The library deals with these concepts: The library deals with these concepts:
* **Widget** -- A class that corresponds to an HTML form widget, e.g. * **Widget** -- A class that corresponds to an HTML form widget, e.g.
``<input type="text">`` or ``<textarea>``. ``<input type="text">`` or ``<textarea>``. This handles rendering of the
widget as HTML.
* **Field** -- A class that is responsible for doing validation, e.g. * **Field** -- A class that is responsible for doing validation, e.g.
an ``EmailField`` that makes sure its data is a valid e-mail address. an ``EmailField`` that makes sure its data is a valid e-mail address.
* **Form** -- A collection of fields that knows how to validate itself and * **Form** -- A collection of fields that knows how to validate itself and
display itself as HTML. display itself as HTML.