~ubuntu-branches/ubuntu/jaunty/python-django/jaunty-backports

« back to all changes in this revision

Viewing changes to docs/ref/models/fields.txt

  • Committer: Bazaar Package Importer
  • Author(s): Scott James Remnant
  • Date: 2008-11-15 19:15:33 UTC
  • mfrom: (1.1.6 upstream)
  • Revision ID: james.westby@ubuntu.com-20081115191533-xbt1ut2xf4fvwtvc
Tags: 1.0.1-0ubuntu1
* New upstream release:
  - Bug fixes.

* The tests/ sub-directory appaers to have been dropped upstream, so pull
  our patch to workaround the tests and modify the rules.

Show diffs side-by-side

added added

removed removed

Lines of Context:
413
413
 
414
414
A :class:`CharField` that checks that the value is a valid e-mail address.
415
415
 
416
 
In Django 0.96, this doesn't accept :attr:`~CharField.max_length`; its
417
 
:class:`~CharField.max_length` is automatically set to 75. In the Django
418
 
development version, :class:`~CharField.max_length` is set to 75 by default, but
419
 
you can specify it to override default behavior.
420
 
 
421
416
``FileField``
422
417
-------------
423
418
 
577
572
 
578
573
The admin represents this as an ``<input type="text">`` (a single-line input).
579
574
 
580
 
**NOTE:** The semantics of :class:`FloatField` have changed in the Django
581
 
development version. See the `Django 0.96 documentation`_ for the old behavior.
582
 
 
583
 
.. _Django 0.96 documentation: http://www.djangoproject.com/documentation/0.96/model-api/#floatfield
584
 
 
585
575
``ImageField``
586
576
--------------
587
577
 
887
877
    add the descriptor for the reverse relationship, allowing
888
878
    :class:`ManyToManyField` relationships to be non-symmetrical.
889
879
    
 
880
.. attribute:: ManyToManyFields.through
 
881
 
 
882
    Django will automatically generate a table to manage many-to-many 
 
883
    relationships. However, if you want to manually specify the intermediary
 
884
    table, you can use the :attr:`~ManyToManyField.through` option to specify
 
885
    the Django model that represents the intermediate table that you want to
 
886
    use.
 
887
    
 
888
    The most common use for this option is when you want to associate
 
889
    :ref:`extra data with a many-to-many relationship <intermediary-manytomany>`.
 
890
 
890
891
.. attribute:: ManyToManyField.db_table
891
892
 
892
893
    The name of the table to create for storing the many-to-many data. If this