Ticket #21858: 21858.diff

File 21858.diff, 2.5 KB (added by timo, 12 months ago)
  • docs/releases/1.6.txt

    diff --git a/docs/releases/1.6.txt b/docs/releases/1.6.txt
    index ca960a1..836596a 100644
    a b Help text of model form fields for ManyToManyField fields 
    638638~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
    639639
    640640HTML rendering of model form fields corresponding to
    641 :class:`~django.db.models.ManyToManyField` ORM model fields used to get the
    642 hard-coded sentence
     641:class:`~django.db.models.ManyToManyField` model fields used to get the
     642hard-coded sentence:
    643643
    644644  *Hold down "Control", or "Command" on a Mac, to select more than one.*
    645645
    646646(or its translation to the active locale) imposed as the help legend shown along
    647647them if neither :attr:`model <django.db.models.Field.help_text>` nor :attr:`form
    648 <django.forms.Field.help_text>` ``help_text`` attribute was specified by the
    649 user (or appended to, if ``help_text`` was provided.)
     648<django.forms.Field.help_text>` ``help_text`` attributes were specified by the
     649user (or this string was appended to any ``help_text`` that was provided).
    650650
    651 This happened always, possibly even with form fields implementing user
    652 interactions that don't involve a keyboard and/or a mouse and was handled at the
    653 model field layer.
    654 
    655 Starting with Django 1.6 this doesn't happen anymore.
     651Since this happened at the model layer, there was no way to prevent the text
     652from appearing in cases where it wasn't applicable such as form fields that
     653implement user interactions that don't involve a keyboard and/or a mouse.
    656654
    657655The change can affect you in a backward incompatible way if you employ custom
    658656model form fields and/or widgets for ``ManyToManyField`` model fields whose UIs
    facilities together with Django built-in form :doc:`fields </ref/forms/fields>` 
    665663and :doc:`widgets </ref/forms/widgets>` aren't affected but need to be aware of
    666664what's described in :ref:`m2m-help_text-deprecation` below.
    667665
    668 This is because, as an ad-hoc temporary backward-compatibility provision, the
    669 described non-standard behavior has been preserved but moved to the model form
    670 field layer and occurs only when the associated widget is
    671 :class:`~django.forms.SelectMultiple` or selected subclasses.
     666Starting with Django 1.6, as an ad-hoc temporary backward-compatibility
     667provision, the logic to add the "Hold down..." sentence has been moved to the
     668model form field layer and modified to add the text only when the associated
     669widget is :class:`~django.forms.SelectMultiple` or selected subclasses.
    672670
    673671QuerySet iteration
    674672~~~~~~~~~~~~~~~~~~
Back to Top