summaryrefslogtreecommitdiff
path: root/docs/ref/forms
diff options
context:
space:
mode:
authorJacob Kaplan-Moss <jacob@jacobian.org>2008-09-02 03:40:42 +0000
committerJacob Kaplan-Moss <jacob@jacobian.org>2008-09-02 03:40:42 +0000
commit64a94691277db17e87614f125d8da78a9995076b (patch)
tree8850007d024ada1901a8965c01e7c6f74ebe0172 /docs/ref/forms
parentc435975cc779a4549591a1c2b32e91f409c33757 (diff)
Fixed #8753: converted "new in ..." callouts to proper Sphinx "versionadded/versionchanged" directives. Thanks to Marc Fargas for all the heavy lifting here.
git-svn-id: http://code.djangoproject.com/svn/django/trunk@8843 bcc190cf-cafb-0310-a4f2-bffc1f526a37
Diffstat (limited to 'docs/ref/forms')
-rw-r--r--docs/ref/forms/api.txt7
-rw-r--r--docs/ref/forms/fields.txt29
-rw-r--r--docs/ref/forms/widgets.txt4
3 files changed, 20 insertions, 20 deletions
diff --git a/docs/ref/forms/api.txt b/docs/ref/forms/api.txt
index f8d8a9940a..72dfcb67c9 100644
--- a/docs/ref/forms/api.txt
+++ b/docs/ref/forms/api.txt
@@ -157,9 +157,8 @@ object::
>>> f.cleaned_data
{'cc_myself': True, 'message': u'Hi there', 'sender': u'foo@example.com', 'subject': u'hello'}
-.. note::
- **New in Django development version** The ``cleaned_data`` attribute was
- called ``clean_data`` in earlier releases.
+.. versionchanged:: 1.0
+ The ``cleaned_data`` attribute was called ``clean_data`` in earlier releases.
Note that any text-based field -- such as ``CharField`` or ``EmailField`` --
always cleans the input into a Unicode string. We'll cover the encoding
@@ -564,7 +563,7 @@ when printed::
Binding uploaded files to a form
--------------------------------
-**New in Django development version**
+.. versionadded:: 1.0
Dealing with forms that have ``FileField`` and ``ImageField`` fields
is a little more complicated than a normal form.
diff --git a/docs/ref/forms/fields.txt b/docs/ref/forms/fields.txt
index 262538fec7..0656c323ae 100644
--- a/docs/ref/forms/fields.txt
+++ b/docs/ref/forms/fields.txt
@@ -219,9 +219,10 @@ fields. We've specified ``auto_id=False`` to simplify the output::
``error_messages``
~~~~~~~~~~~~~~~~~~
+.. versionadded:: 1.0
+
.. attribute:: Field.error_messages
-**New in Django development version**
The ``error_messages`` argument lets you override the default messages that the
field will raise. Pass in a dictionary with keys matching the error messages you
@@ -314,9 +315,9 @@ For each field, we describe the default widget used if you don't specify
the field has ``required=True``.
* Error message keys: ``required``
-**New in Django development version:** The empty value for a ``CheckboxInput``
-(and hence the standard ``BooleanField``) has changed to return ``False``
-instead of ``None`` in the development version.
+.. versionchanged:: 1.0
+ The empty value for a ``CheckboxInput`` (and hence the standard ``BooleanField``)
+ has changed to return ``False`` instead of ``None`` in the development version.
.. note::
@@ -448,15 +449,15 @@ If no ``input_formats`` argument is provided, the default input formats are::
'%m/%d/%y %H:%M', # '10/25/06 14:30'
'%m/%d/%y', # '10/25/06'
-**New in Django development version:** The ``DateTimeField`` used to use a
-``TextInput`` widget by default. This has now changed.
+.. versionchanged:: 1.0
+ The ``DateTimeField`` used to use a ``TextInput`` widget by default. This has now changed.
``DecimalField``
~~~~~~~~~~~~~~~~
-.. class:: DecimalField(**kwargs)
+.. versionadded:: 1.0
-**New in Django development version**
+.. class:: DecimalField(**kwargs)
* Default widget: ``TextInput``
* Empty value: ``None``
@@ -503,9 +504,9 @@ given length.
``FileField``
~~~~~~~~~~~~~
-.. class:: FileField(**kwargs)
+.. versionadded:: 1.0
-**New in Django development version**
+.. class:: FileField(**kwargs)
* Default widget: ``FileInput``
* Empty value: ``None``
@@ -523,9 +524,9 @@ When you use a ``FileField`` in a form, you must also remember to
``FilePathField``
~~~~~~~~~~~~~~~~~
-.. class:: FilePathField(**kwargs)
+.. versionadded:: 1.0
-**New in Django development version**
+.. class:: FilePathField(**kwargs)
* Default widget: ``Select``
* Empty value: ``None``
@@ -569,9 +570,9 @@ These control the range of values permitted in the field.
``ImageField``
~~~~~~~~~~~~~~
-.. class:: ImageField(**kwargs)
+.. versionadded:: 1.0
-**New in Django development version**
+.. class:: ImageField(**kwargs)
* Default widget: ``FileInput``
* Empty value: ``None``
diff --git a/docs/ref/forms/widgets.txt b/docs/ref/forms/widgets.txt
index a7d35f4ddd..c9cc292b30 100644
--- a/docs/ref/forms/widgets.txt
+++ b/docs/ref/forms/widgets.txt
@@ -38,9 +38,9 @@ commonly used groups of widgets:
.. class:: DateTimeInput
- Date/time input as a simple text box: ``<input type='text' ...>``
+ .. versionadded:: 1.0
- **New in Django development version:**
+ Date/time input as a simple text box: ``<input type='text' ...>``
.. class:: Textarea