Chris Jerdonek 
								
							 
						 
						
							
							
							
							
								
							
							
								6559a55eed 
								
							 
						 
						
							
							
								
								Fixed   #32933  -- Documented BoundField.initial as preferred over Form.get_initial_for_field().  
							
							
							
						 
						
							2021-07-27 16:47:09 +02:00 
							
								 
							
							
								 
							
						 
					 
				
					
						
							
								
								
									Mariusz Felisiak 
								
							 
						 
						
							
							
							
							
								
							
							
								b7dd89ed53 
								
							 
						 
						
							
							
								
								Removed versionadded/changed annotations for 3.1.  
							
							
							
						 
						
							2021-01-14 17:50:04 +01:00 
							
								 
							
							
								 
							
						 
					 
				
					
						
							
								
								
									Tim Schilling 
								
							 
						 
						
							
							
							
							
								
							
							
								34a69c2458 
								
							 
						 
						
							
							
								
								Corrected outputting BooleanField as HTML in forms docs.  
							
							
							
						 
						
							2020-04-24 09:08:05 +02:00 
							
								 
							
							
								 
							
						 
					 
				
					
						
							
								
								
									David Smith 
								
							 
						 
						
							
							
							
							
								
							
							
								734fde7714 
								
							 
						 
						
							
							
								
								Refs  #10427  -- Corrected BoundField.css_classes() signature in docs.  
							
							
							
						 
						
							2020-04-10 07:37:54 +02:00 
							
								 
							
							
								 
							
						 
					 
				
					
						
							
								
								
									David Smith 
								
							 
						 
						
							
							
							
							
								
							
							
								a350bfa6f4 
								
							 
						 
						
							
							
								
								Fixed   #13009  -- Added BoundField.widget_type property.  
							
							
							
						 
						
							2020-04-10 07:11:14 +02:00 
							
								 
							
							
								 
							
						 
					 
				
					
						
							
								
								
									Tobias Kunze 
								
							 
						 
						
							
							
							
							
								
							
							
								4a954cfd11 
								
							 
						 
						
							
							
								
								Fixed   #30573  -- Rephrased documentation to avoid words that minimise the involved difficulty.  
							
							... 
							
							
							
							This patch does not remove all occurrences of the words in question.
Rather, I went through all of the occurrences of the words listed
below, and judged if they a) suggested the reader had some kind of
knowledge/experience, and b) if they added anything of value (including
tone of voice, etc). I left most of the words alone. I looked at the
following words:
- simply/simple
- easy/easier/easiest
- obvious
- just
- merely
- straightforward
- ridiculous
Thanks to Carlton Gibson for guidance on how to approach this issue, and
to Tim Bell for providing the idea. But the enormous lion's share of
thanks go to Adam Johnson for his patient and helpful review. 
							
						 
						
							2019-09-06 13:27:46 +02:00 
							
								 
							
							
								 
							
						 
					 
				
					
						
							
								
								
									Bruno Furtado 
								
							 
						 
						
							
							
							
							
								
							
							
								571ab44e8a 
								
							 
						 
						
							
							
								
								Fixed   #30321  -- Added example of changed_data to forms docs.  
							
							
							
						 
						
							2019-04-09 22:52:33 +02:00 
							
								 
							
							
								 
							
						 
					 
				
					
						
							
								
								
									Tim Graham 
								
							 
						 
						
							
							
							
							
								
							
							
								7543ab1f8d 
								
							 
						 
						
							
							
								
								Removed versionadded/changed annotations for 2.0.  
							
							
							
						 
						
							2018-05-17 11:00:10 -04:00 
							
								 
							
							
								 
							
						 
					 
				
					
						
							
								
								
									Jon Dufresne 
								
							 
						 
						
							
							
							
							
								
							
							
								ff05de760c 
								
							 
						 
						
							
							
								
								Fixed   #29038  -- Removed closing slash from HTML void tags.  
							
							
							
						 
						
							2018-01-21 02:09:10 -05:00 
							
								 
							
							
								 
							
						 
					 
				
					
						
							
								
								
									Tim Graham 
								
							 
						 
						
							
							
							
							
								
							
							
								5446b72003 
								
							 
						 
						
							
							
								
								Removed versionadded/changed annotations for 1.11.  
							
							
							
						 
						
							2017-09-22 12:51:18 -04:00 
							
								 
							
							
								 
							
						 
					 
				
					
						
							
								
								
									Jon Dufresne 
								
							 
						 
						
							
							
							
							
								
							
							
								c3e638112d 
								
							 
						 
						
							
							
								
								Corrected REPL example in forms docs for Python 3.  
							
							
							
						 
						
							2017-05-27 19:28:37 -04:00 
							
								 
							
							
								 
							
						 
					 
				
					
						
							
								
								
									Tim Heap 
								
							 
						 
						
							
							
							
							
								
							
							
								5b6181f4d5 
								
							 
						 
						
							
							
								
								Fixed   #27922  -- Added ErrorDict.get_json_data().  
							
							
							
						 
						
							2017-05-27 09:19:42 -04:00 
							
								 
							
							
								 
							
						 
					 
				
					
						
							
								
								
									Vytis Banaitis 
								
							 
						 
						
							
							
							
							
								
							
							
								d1bab24e01 
								
							 
						 
						
							
							
								
								Refs  #23919 ,  #27778  -- Removed obsolete mentions of unicode.  
							
							
							
						 
						
							2017-01-26 08:19:27 -05:00 
							
								 
							
							
								 
							
						 
					 
				
					
						
							
								
								
									Tim Graham 
								
							 
						 
						
							
							
							
							
								
							
							
								f6acd1d271 
								
							 
						 
						
							
							
								
								Refs  #23919  -- Removed Python 2 notes in docs.  
							
							
							
						 
						
							2017-01-18 11:51:29 -05:00 
							
								 
							
							
								 
							
						 
					 
				
					
						
							
								
								
									Tim Graham 
								
							 
						 
						
							
							
							
							
								
							
							
								e27e4c0339 
								
							 
						 
						
							
							
								
								Removed versionadded/changed annotations for 1.10.  
							
							
							
						 
						
							2017-01-17 20:52:05 -05:00 
							
								 
							
							
								 
							
						 
					 
				
					
						
							
								
								
									Preston Timmons 
								
							 
						 
						
							
							
							
							
								
							
							
								b52c73008a 
								
							 
						 
						
							
							
								
								Fixed   #15667  -- Added template-based widget rendering.  
							
							... 
							
							
							
							Thanks Carl Meyer and Tim Graham for contributing to the patch. 
							
						 
						
							2016-12-27 17:50:10 -05:00 
							
								 
							
							
								 
							
						 
					 
				
					
						
							
								
								
									Zach Borboa 
								
							 
						 
						
							
							
							
							
								
							
							
								90c3b11e87 
								
							 
						 
						
							
							
								
								Fixed   #27361  -- Used "from django import forms" in forms api docs.  
							
							
							
						 
						
							2016-10-19 09:55:21 -04:00 
							
								 
							
							
								 
							
						 
					 
				
					
						
							
								
								
									Jon Dufresne 
								
							 
						 
						
							
							
							
							
								
							
							
								f5c6d3c8d9 
								
							 
						 
						
							
							
								
								Fixed   #27068  -- Unified form field initial data retrieval.  
							
							
							
						 
						
							2016-08-18 17:55:47 -07:00 
							
								 
							
							
								 
							
						 
					 
				
					
						
							
								
								
									Jon Dufresne 
								
							 
						 
						
							
							
							
							
								
							
							
								4773ed2e31 
								
							 
						 
						
							
							
								
								Fixed incorrect doc reference to Field.initial.  
							
							
							
						 
						
							2016-08-17 10:27:33 -04:00 
							
								 
							
							
								 
							
						 
					 
				
					
						
							
								
								
									Jon Dufresne 
								
							 
						 
						
							
							
							
							
								
							
							
								50e299dbfb 
								
							 
						 
						
							
							
								
								Fixed   #26928  -- Changed forms' checked attribute to HTML5 boolean style.  
							
							
							
						 
						
							2016-08-04 19:16:54 -04:00 
							
								 
							
							
								 
							
						 
					 
				
					
						
							
								
								
									Tim Graham 
								
							 
						 
						
							
							
							
							
								
							
							
								46a38307c2 
								
							 
						 
						
							
							
								
								Removed versionadded/changed annotations for 1.9.  
							
							
							
						 
						
							2016-05-20 11:44:29 -04:00 
							
								 
							
							
								 
							
						 
					 
				
					
						
							
								
								
									Jon Dufresne 
								
							 
						 
						
							
							
							
							
								
							
							
								ec6121693f 
								
							 
						 
						
							
							
								
								Fixed   #22383  -- Added support for HTML5 required attribute on required form fields.  
							
							
							
						 
						
							2016-04-21 19:16:38 -04:00 
							
								 
							
							
								 
							
						 
					 
				
					
						
							
								
								
									Tim Graham 
								
							 
						 
						
							
							
							
							
								
							
							
								53e8ab580f 
								
							 
						 
						
							
							
								
								Fixed   #26265  -- Clarified RadioSelect container's HTML id.  
							
							
							
						 
						
							2016-03-19 18:01:10 -04:00 
							
								 
							
							
								 
							
						 
					 
				
					
						
							
								
								
									Elif T. Kus 
								
							 
						 
						
							
							
							
							
								
							
							
								bca9faae95 
								
							 
						 
						
							
							
								
								Fixed   #26020  -- Normalized header stylings in docs.  
							
							
							
						 
						
							2016-01-22 12:12:17 -05:00 
							
								 
							
							
								 
							
						 
					 
				
					
						
							
								
								
									Tim Graham 
								
							 
						 
						
							
							
							
							
								
							
							
								54848a96dd 
								
							 
						 
						
							
							
								
								Removed versionadded/changed annotations for 1.8.  
							
							
							
						 
						
							2015-09-23 19:31:11 -04:00 
							
								 
							
							
								 
							
						 
					 
				
					
						
							
								
								
									Moritz Sichert 
								
							 
						 
						
							
							
							
							
								
							
							
								2f53d342f1 
								
							 
						 
						
							
							
								
								Fixed   #12856  -- Documented BoundField API.  
							
							
							
						 
						
							2015-09-21 08:42:14 -04:00 
							
								 
							
							
								 
							
						 
					 
				
					
						
							
								
								
									Moritz Sichert 
								
							 
						 
						
							
							
							
							
								
							
							
								535809e121 
								
							 
						 
						
							
							
								
								Fixed   #25294  -- Allowed custom BoundFields on forms.  
							
							
							
						 
						
							2015-09-16 10:18:07 -04:00 
							
								 
							
							
								 
							
						 
					 
				
					
						
							
								
								
									Tim Graham 
								
							 
						 
						
							
							
							
							
								
							
							
								5b5a27942b 
								
							 
						 
						
							
							
								
								Fixed   #25268  -- Tweaked wording in docs/ref/forms/api.txt  
							
							
							
						 
						
							2015-08-14 08:27:38 -04:00 
							
								 
							
							
								 
							
						 
					 
				
					
						
							
								
								
									Alasdair Nicol 
								
							 
						 
						
							
							
							
							
								
							
							
								5c98223f39 
								
							 
						 
						
							
							
								
								Fixed   #24191  -- Documented Form.changed_data  
							
							... 
							
							
							
							Thanks rhertzog and Björn Påhlsson for the suggestion. 
							
						 
						
							2015-06-04 13:51:26 -04:00 
							
								 
							
							
								 
							
						 
					 
				
					
						
							
								
								
									Paweł Marczewski 
								
							 
						 
						
							
							
							
							
								
							
							
								4df7e8483b 
								
							 
						 
						
							
							
								
								Fixed   #24788  -- Allowed Forms to specify a prefix at the class level.  
							
							
							
						 
						
							2015-05-25 20:23:31 -04:00 
							
								 
							
							
								 
							
						 
					 
				
					
						
							
								
								
									Thomas Tanner 
								
							 
						 
						
							
							
							
							
								
							
							
								28986da4ca 
								
							 
						 
						
							
							
								
								Fixed   #5986  -- Added ability to customize order of Form fields  
							
							
							
						 
						
							2015-03-16 09:12:57 -04:00 
							
								 
							
							
								 
							
						 
					 
				
					
						
							
								
								
									Tim Graham 
								
							 
						 
						
							
							
							
							
								
							
							
								c79faae761 
								
							 
						 
						
							
							
								
								Removed versionadded/changed notes for 1.7.  
							
							
							
						 
						
							2015-02-01 21:02:40 -05:00 
							
								 
							
							
								 
							
						 
					 
				
					
						
							
								
								
									Tim Graham 
								
							 
						 
						
							
							
							
							
								
							
							
								ebfadb8080 
								
							 
						 
						
							
							
								
								Corrected example in Form.has_changed() docs.  
							
							
							
						 
						
							2014-12-05 13:17:14 -05:00 
							
								 
							
							
								 
							
						 
					 
				
					
						
							
								
								
									Gabriel Muñumel 
								
							 
						 
						
							
							
							
							
								
							
							
								deed00c0d8 
								
							 
						 
						
							
							
								
								Fixed   #23162  -- Renamed forms.Field._has_changed() to has_changed().  
							
							
							
						 
						
							2014-08-15 08:14:45 -04:00 
							
								 
							
							
								 
							
						 
					 
				
					
						
							
								
								
									Zhaorong Ma 
								
							 
						 
						
							
							
							
							
								
							
							
								bef5b9b7cd 
								
							 
						 
						
							
							
								
								Fixed a grammar error in docs/ref/forms/api.txt.  
							
							
							
						 
						
							2014-08-14 12:13:52 -04:00 
							
								 
							
							
								 
							
						 
					 
				
					
						
							
								
								
									Tim Graham 
								
							 
						 
						
							
							
							
							
								
							
							
								edcc75e5ac 
								
							 
						 
						
							
							
								
								Fixed   #21792  -- Documented Form.has_changed()  
							
							... 
							
							
							
							Thanks bjb at credil.org for the suggestion and
Ivan Mesic for the draft patch. 
							
						 
						
							2014-08-05 08:44:57 -04:00 
							
								 
							
							
								 
							
						 
					 
				
					
						
							
								
								
									Tim Graham 
								
							 
						 
						
							
							
							
							
								
							
							
								874053edf9 
								
							 
						 
						
							
							
								
								Fixed   #21942  -- Moved Form.clean() to form API docs.  
							
							... 
							
							
							
							Thanks cjerdonek for the suggestion. 
							
						 
						
							2014-06-30 16:30:57 -04:00 
							
								 
							
							
								 
							
						 
					 
				
					
						
							
								
								
									Daniele Procida 
								
							 
						 
						
							
							
							
							
								
							
							
								cd20b5d186 
								
							 
						 
						
							
							
								
								Fixed   #22796  -- Added a more basic explanations of forms.  
							
							... 
							
							
							
							Thanks bmispelon, kezabelle, jorgecarleitao, and timgraham for reviews. 
							
						 
						
							2014-06-24 14:55:22 -04:00 
							
								 
							
							
								 
							
						 
					 
				
					
						
							
								
								
									Marc Tamlyn 
								
							 
						 
						
							
							
							
							
								
							
							
								9fb0f5dddc 
								
							 
						 
						
							
							
								
								Fixed   #22510  -- Harden field removal to only None.  
							
							... 
							
							
							
							Refs #8620 .
If we allow any value to remove form fields then we get name clashes
with method names, media classes etc. There was a backwards
incompatibility introduced meaning ModelForm subclasses with declared
fields called media or clean would lose those fields.
Field removal is now only permitted by using the sentinel value None.
The docs have been slightly reworded to refer to removal of fields
rather than shadowing.
Thanks to gcbirzan for the report and initial patch, and several of the
core team for opinions. 
							
						 
						
							2014-05-24 13:10:50 +01:00 
							
								 
							
							
								 
							
						 
					 
				
					
						
							
								
								
									Julen Ruiz Aizpuru 
								
							 
						 
						
							
							
							
							
								
							
							
								5eb81ce445 
								
							 
						 
						
							
							
								
								Fixed   #22533  -- Added label_suffix parameter to form fields.  
							
							... 
							
							
							
							Fields can now receive the `label_suffix` attribute, which will override
a form's `label_suffix`.
This enhances the possibility to customize form's `label_suffix`, allowing
to use such customizations while using shortcuts such as
`{{ form.as_p }}`.
Note that the field's own customization can be overridden at runtime by
using the `label_prefix` parameter to `BoundField.label_tag()`.
Refs #18134 . 
							
						 
						
							2014-05-13 09:09:33 -04:00 
							
								 
							
							
								 
							
						 
					 
				
					
						
							
								
								
									Tim Graham 
								
							 
						 
						
							
							
							
							
								
							
							
								d2f4553d70 
								
							 
						 
						
							
							
								
								Fixed   #22216  -- Added Form.non_field_errors to form API doc.  
							
							
							
						 
						
							2014-04-05 18:16:01 -04:00 
							
								 
							
							
								 
							
						 
					 
				
					
						
							
								
								
									Tim Graham 
								
							 
						 
						
							
							
							
							
								
							
							
								51c8045145 
								
							 
						 
						
							
							
								
								Removed versionadded/changed annotations for 1.6.  
							
							
							
						 
						
							2014-03-24 11:42:56 -04:00 
							
								 
							
							
								 
							
						 
					 
				
					
						
							
								
								
									Anubhav Joshi 
								
							 
						 
						
							
							
							
							
								
							
							
								416a858023 
								
							 
						 
						
							
							
								
								Fixed   #17922  -- Added required_css_class to form label.  
							
							... 
							
							
							
							Thanks hanson2010 for the suggestion. 
							
						 
						
							2014-03-24 08:11:54 -04:00 
							
								 
							
							
								 
							
						 
					 
				
					
						
							
								
								
									Loic Bistuer 
								
							 
						 
						
							
							
							
							
								
							
							
								7ac8380799 
								
							 
						 
						
							
							
								
								Fixed   #22318  -- Added Form.has_error() to easily check if a given error has happened.  
							
							
							
						 
						
							2014-03-24 07:21:32 -04:00 
							
								 
							
							
								 
							
						 
					 
				
					
						
							
								
								
									Claude Paroz 
								
							 
						 
						
							
							
							
							
								
							
							
								3a97f992fb 
								
							 
						 
						
							
							
								
								Fixed   #22313  -- Removed 'u' prefixes from documentation  
							
							
							
						 
						
							2014-03-22 21:32:20 +01:00 
							
								 
							
							
								 
							
						 
					 
				
					
						
							
								
								
									vvojvoda 
								
							 
						 
						
							
							
							
							
								
							
							
								c23b3717be 
								
							 
						 
						
							
							
								
								Fixed   #21962  -- Added escape_html flag to ErrorDict.as_json()  
							
							
							
						 
						
							2014-02-28 07:05:55 -05:00 
							
								 
							
							
								 
							
						 
					 
				
					
						
							
								
								
									Loic Bistuer 
								
							 
						 
						
							
							
							
							
								
							
							
								2e4200b5c7 
								
							 
						 
						
							
							
								
								Fixed   #21654  -- Documented a use-case for Form.errors.as_data().  
							
							... 
							
							
							
							Thanks selwin for the suggestion. 
							
						 
						
							2014-02-14 06:52:50 -05:00 
							
								 
							
							
								 
							
						 
					 
				
					
						
							
								
								
									Alasdair Nicol 
								
							 
						 
						
							
							
							
							
								
							
							
								8aa1efff6d 
								
							 
						 
						
							
							
								
								Fixed   #21951  -- Updated docs to use __str__ for Python 3  
							
							... 
							
							
							
							Thanks Tim Graham for the report and recommendations 
							
						 
						
							2014-02-13 07:12:40 -05:00 
							
								 
							
							
								 
							
						 
					 
				
					
						
							
								
								
									Baptiste Mispelon 
								
							 
						 
						
							
							
							
							
								
							
							
								05d36dc06e 
								
							 
						 
						
							
							
								
								Always use parentheses when documenting a method with no arguments.  
							
							
							
						 
						
							2014-01-22 22:26:10 +01:00 
							
								 
							
							
								 
							
						 
					 
				
					
						
							
								
								
									Vajrasky Kok 
								
							 
						 
						
							
							
							
							
								
							
							
								ea83102d0f 
								
							 
						 
						
							
							
								
								Fixed   #21319  -- Added documentation for the Form.fields attribute.  
							
							... 
							
							
							
							Thanks pydanny for the report. Also, added documentation about
base_fields attribute and its difference with fields attribute. 
							
						 
						
							2014-01-02 19:43:26 -05:00