BoundField documentation: original field

[tga]

Please add in the documentation a mention on how to get the original field of a BoundField.

Locations:
​https://docs.djangoproject.com/en/dev/topics/forms/#looping-over-the-form-s-fields
​https://docs.djangoproject.com/en/dev/ref/forms/api/#django.forms.BoundField

In these two locations it would be very useful to have a mention like:

--

{{ field.field }}
The original field instance, as added to the form object, e.g. a forms.CharField instance.

--

Details:
When adding field programatically to a form, it comes naturally to want to add extra fields to that object and then read them back in the template. However, as the docs clearly state, iterating over a (bound) form returns BoundFields instead of the original Field objects put into the form. There is no mention in the docs how to get to the original field instance in the template.

Cheers!

[tga]

Created pull request: ​https://github.com/django/django/pull/685

[Tim Graham <timograham@…>]

In fdaaa241715ece2f706041faf16fb282e2782593:

Fixed #19700 - Added documentation for BoundField.field.

Thanks Tiberiu Ana for the report and patch.

[Tim Graham <timograham@…>]

In f28fbe7314712d3e594a0f6509361378162cc7ea:

[1.5.x] Fixed #19700 - Added documentation for BoundField.field.

Thanks Tiberiu Ana for the report and patch.

Backport of fdaaa24171 from master

[Tim Graham <timograham@…>]

In f28fbe7314712d3e594a0f6509361378162cc7ea:

[1.5.x] Fixed #19700 - Added documentation for BoundField.field.

Thanks Tiberiu Ana for the report and patch.

Backport of fdaaa24171 from master