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 
						 
				 
			
				
					
						
							
							
								Mariusz Felisiak 
							
						 
					 
					
						
						
							
						
						35319bf12c 
					 
					
						
						
							
							Alphabetized imports in various docs.  
						
						... 
						
						
						
						Follow-up of d97cce34097d3fe36c62 
						
						
					 
					
						2018-05-12 19:37:42 +02:00 
						 
				 
			
				
					
						
							
							
								Tim Graham 
							
						 
					 
					
						
						
							
						
						8863c475c5 
					 
					
						
						
							
							Fixed   #27821  -- Clarified docs of the return value of Form.clean_<fieldname>().  
						
						... 
						
						
						
						Thanks Christian Ullrich for the report and review. 
						
						
					 
					
						2017-02-08 08:38:08 -05:00 
						 
				 
			
				
					
						
							
							
								chillaranand 
							
						 
					 
					
						
						
							
						
						dc165ec8e5 
					 
					
						
						
							
							Refs  #23919  -- Replaced super(ClassName, self) with super() in docs.  
						
						
						
						
					 
					
						2017-01-25 11:53:05 -05:00 
						 
				 
			
				
					
						
							
							
								Anderson Resende 
							
						 
					 
					
						
						
							
						
						2032bcf182 
					 
					
						
						
							
							Fixed   #26806  -- Triple quoted docstrings in docs/ref/forms/validation.txt.  
						
						
						
						
					 
					
						2016-06-27 09:06:54 -04:00 
						 
				 
			
				
					
						
							
							
								Elif T. Kus 
							
						 
					 
					
						
						
							
						
						bca9faae95 
					 
					
						
						
							
							Fixed   #26020  -- Normalized header stylings in docs.  
						
						
						
						
					 
					
						2016-01-22 12:12:17 -05:00 
						 
				 
			
				
					
						
							
							
								Andrew Plummer 
							
						 
					 
					
						
						
							
						
						1aa8bf9b43 
					 
					
						
						
							
							Fixed typo in docs/ref/forms/validation.txt.  
						
						
						
						
					 
					
						2015-12-09 07:20:33 -05:00 
						 
				 
			
				
					
						
							
							
								Tim Graham 
							
						 
					 
					
						
						
							
						
						80855a4b37 
					 
					
						
						
							
							Fixed   #21894  -- Corrected a form.clean() example in case a superclass doesn't return data.  
						
						
						
						
					 
					
						2015-10-21 13:50:48 -04:00 
						 
				 
			
				
					
						
							
							
								Nick Smith 
							
						 
					 
					
						
						
							
						
						b9bf61ce61 
					 
					
						
						
							
							Used PEP 8 style indentation in forms docs.  
						
						
						
						
					 
					
						2015-06-11 12:21:53 -04:00 
						 
				 
			
				
					
						
							
							
								I am Clinton 
							
						 
					 
					
						
						
							
						
						73b5b0b4a5 
					 
					
						
						
							
							Minor edits to docs/ref/forms/validation.txt  
						
						
						
						
					 
					
						2015-05-25 13:19:21 -04:00 
						 
				 
			
				
					
						
							
							
								minusf 
							
						 
					 
					
						
						
							
						
						66f5aa9fa5 
					 
					
						
						
							
							Fixed typos in docs/ref/forms/validation.txt.  
						
						
						
						
					 
					
						2015-02-03 12:26:58 -05:00 
						 
				 
			
				
					
						
							
							
								Tim Graham 
							
						 
					 
					
						
						
							
						
						c79faae761 
					 
					
						
						
							
							Removed versionadded/changed notes for 1.7.  
						
						
						
						
					 
					
						2015-02-01 21:02:40 -05:00 
						 
				 
			
				
					
						
							
							
								Alasdair Nicol 
							
						 
					 
					
						
						
							
						
						38ab0f13fa 
					 
					
						
						
							
							Added missing backticks to form validation docs  
						
						
						
						
					 
					
						2014-11-20 11:09:21 -05:00 
						 
				 
			
				
					
						
							
							
								Loic Bistuer 
							
						 
					 
					
						
						
							
						
						f1f0c4f16b 
					 
					
						
						
							
							Removed confusing paragraph from the docs.  
						
						... 
						
						
						
						This snippet wasn't particularly helpful as `add_error()` is described
in greater details in the following section.
Thanks Claude Paroz for the report. 
						
						
					 
					
						2014-11-05 16:00:30 +07:00 
						 
				 
			
				
					
						
							
							
								Simon Charette 
							
						 
					 
					
						
						
							
						
						ab9c886459 
					 
					
						
						
							
							Fixed   #23391  -- Removed an erroneous backtip from the form's documentation.  
						
						... 
						
						
						
						Thanks to Trac alias nessita for the report. 
						
						
					 
					
						2014-08-31 20:06:38 -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 
						 
				 
			
				
					
						
							
							
								Maxime Lorant 
							
						 
					 
					
						
						
							
						
						c307383ec9 
					 
					
						
						
							
							Fixed typo in docs/ref/forms/validation.txt.  
						
						
						
						
					 
					
						2014-06-11 17:17:21 -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 
						 
				 
			
				
					
						
							
							
								Claude Paroz 
							
						 
					 
					
						
						
							
						
						3a97f992fb 
					 
					
						
						
							
							Fixed   #22313  -- Removed 'u' prefixes from documentation  
						
						
						
						
					 
					
						2014-03-22 21:32:20 +01: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 
						 
				 
			
				
					
						
							
							
								Baptiste Mispelon 
							
						 
					 
					
						
						
							
						
						05d36dc06e 
					 
					
						
						
							
							Always use parentheses when documenting a method with no arguments.  
						
						
						
						
					 
					
						2014-01-22 22:26:10 +01:00 
						 
				 
			
				
					
						
							
							
								Loic Bistuer 
							
						 
					 
					
						
						
							
						
						b72b85af15 
					 
					
						
						
							
							Removed Form._errors from the docs in favor of the add_error API.  
						
						
						
						
					 
					
						2013-11-30 01:00:53 +07:00 
						 
				 
			
				
					
						
							
							
								Loic Bistuer 
							
						 
					 
					
						
						
							
						
						f563c339ca 
					 
					
						
						
							
							Fixed   #20867  -- Added the Form.add_error() method.  
						
						... 
						
						
						
						Refs #20199  #16986 .
Thanks @akaariai, @bmispelon, @mjtamlyn, @timgraham for the reviews. 
						
						
					 
					
						2013-11-30 01:00:53 +07:00 
						 
				 
			
				
					
						
							
							
								Baptiste Mispelon 
							
						 
					 
					
						
						
							
						
						0048ed77c7 
					 
					
						
						
							
							Fixed typos in previous commit ( 9aa6d4bdb6).  
						
						
						
						
					 
					
						2013-11-12 20:42:44 +01:00 
						 
				 
			
				
					
						
							
							
								Baptiste Mispelon 
							
						 
					 
					
						
						
							
						
						9aa6d4bdb6 
					 
					
						
						
							
							Removed a mention of Form._errors from the documentation.  
						
						... 
						
						
						
						Also removed a sentence that was incorrect: raising a
`ValidationError` inside `Form.clean` doesn't clear the
`cleaned_data` attribute.
Thanks to loic84 and timograham for the review. 
						
						
					 
					
						2013-11-12 20:27:21 +01:00 
						 
				 
			
				
					
						
							
							
								Ben Huckvale 
							
						 
					 
					
						
						
							
						
						98e0453f00 
					 
					
						
						
							
							Fixed   #21120  -- Added more explicit text on using validators and link to writing validators.  
						
						... 
						
						
						
						Thanks nicolas at niconomicon.net for the suggestion. 
						
						
					 
					
						2013-09-23 10:37:41 -04:00 
						 
				 
			
				
					
						
							
							
								Tim Graham 
							
						 
					 
					
						
						
							
						
						18ffdb1772 
					 
					
						
						
							
							Fixed   #17627  -- Renamed util.py files to utils.py  
						
						... 
						
						
						
						Thanks PaulM for the suggestion and Luke Granger-Brown and
Wiktor Kołodziej for the initial patch. 
						
						
					 
					
						2013-09-16 12:52:05 -04:00 
						 
				 
			
				
					
						
							
							
								Tim Graham 
							
						 
					 
					
						
						
							
						
						ebfe42d018 
					 
					
						
						
							
							Fixed   #21009  -- Added a versionchanged note regarding changes to clean().  
						
						... 
						
						
						
						refs [fb1dd6b13a1c4a9bd9ad 
						
						
					 
					
						2013-09-05 05:47:45 -04:00 
						 
				 
			
				
					
						
							
							
								Tim Graham 
							
						 
					 
					
						
						
							
						
						7b69c3e775 
					 
					
						
						
							
							Removed versionadded/changed annotations for 1.5  
						
						
						
						
					 
					
						2013-08-19 09:09:41 -04:00 
						 
				 
			
				
					
						
							
							
								Tim Graham 
							
						 
					 
					
						
						
							
						
						8442268869 
					 
					
						
						
							
							Added an anchor for django.forms.Form.clean in docs  
						
						
						
						
					 
					
						2013-08-08 14:13:52 -04:00 
						 
				 
			
				
					
						
							
							
								Marc Tamlyn 
							
						 
					 
					
						
						
							
						
						fb1dd6b13a 
					 
					
						
						
							
							Form.clean() does not need to return cleaned_data.  
						
						... 
						
						
						
						If it does, that will be used as the cleaned_data. The default
implementation has been changed to match this change. 
						
						
					 
					
						2013-08-08 14:05:55 +01:00 
						 
				 
			
				
					
						
							
							
								Tim Graham 
							
						 
					 
					
						
						
							
						
						05ea5a2139 
					 
					
						
						
							
							Fixed   #20823  -- Typo in docs/ref/forms/validation.txt  
						
						
						
						
					 
					
						2013-07-29 18:41:08 -04:00 
						 
				 
			
				
					
						
							
							
								Loic Bistuer 
							
						 
					 
					
						
						
							
						
						ee77d4b253 
					 
					
						
						
							
							Fixed   #20199  -- Allow ModelForm fields to override error_messages from model fields  
						
						
						
						
					 
					
						2013-06-18 08:01:17 -04:00 
						 
				 
			
				
					
						
							
							
								leandrafinger 
							
						 
					 
					
						
						
							
						
						08b501e7d3 
					 
					
						
						
							
							add missing imports to the examples in the 'Forms'  
						
						
						
						
					 
					
						2013-05-19 13:31:45 +02:00 
						 
				 
			
				
					
						
							
							
								Juan Catalano 
							
						 
					 
					
						
						
							
						
						78c842a323 
					 
					
						
						
							
							Adapted uses of versionchanged/versionadded to the new form.  
						
						... 
						
						
						
						Refs #20104 . 
						
						
					 
					
						2013-04-20 17:18:35 +02:00 
						 
				 
			
				
					
						
							
							
								Claude Paroz 
							
						 
					 
					
						
						
							
						
						2f121dfe63 
					 
					
						
						
							
							Fixed   #17051  -- Removed some 'invalid' field error messages  
						
						... 
						
						
						
						When the 'invalid' error message is set at field level, it masks
the error message raised by the validator, if any. 
						
						
					 
					
						2013-03-14 17:03:43 +01:00 
						 
				 
			
				
					
						
							
							
								Adrien Lemaire 
							
						 
					 
					
						
						
							
						
						2c8267bf3d 
					 
					
						
						
							
							Fixed   #17899  -- Rewrote [Ee]-mail to [Ee]mail  
						
						
						
						
					 
					
						2012-09-26 14:14:51 +02:00 
						 
				 
			
				
					
						
							
							
								Brad Pitcher 
							
						 
					 
					
						
						
							
						
						c634375e9c 
					 
					
						
						
							
							clarify clean_<field> docs, ticket  #18917  
						
						
						
						
					 
					
						2012-09-07 10:43:55 -04:00 
						 
				 
			
				
					
						
							
							
								Claude Paroz 
							
						 
					 
					
						
						
							
						
						121fd109de 
					 
					
						
						
							
							Fixed   #5524  -- Do not remove cleaned_data when a form fails validation  
						
						... 
						
						
						
						cleaned_data is no longer deleted when form validation fails but only
contains the data that did validate.
Thanks to the various contributors to this patch (see ticket). 
						
						
					 
					
						2012-08-04 14:22:23 +02:00 
						 
				 
			
				
					
						
							
							
								Aymeric Augustin 
							
						 
					 
					
						
						
							
						
						33999d9871 
					 
					
						
						
							
							Fixed   #18445  -- Added a links in the docs.  
						
						... 
						
						
						
						Thanks Audrey Roy for the patch. 
						
						
					 
					
						2012-06-07 22:11:24 +02:00 
						 
				 
			
				
					
						
							
							
								Claude Paroz 
							
						 
					 
					
						
						
							
						
						4a103086d5 
					 
					
						
						
							
							Fixed   #18269  -- Applied unicode_literals for Python 3 compatibility.  
						
						... 
						
						
						
						Thanks Vinay Sajip for the support of his django3 branch and
Jannis Leidel for the review. 
						
						
					 
					
						2012-06-07 18:08:47 +02:00 
						 
				 
			
				
					
						
							
							
								Aymeric Augustin 
							
						 
					 
					
						
						
							
						
						c28e700c7e 
					 
					
						
						
							
							Removed references to changes made in 1.2.  
						
						... 
						
						
						
						Thanks Florian Apolloner for the patch. 
						
						
					 
					
						2012-06-07 15:02:35 +02:00 
						 
				 
			
				
					
						
							
							
								Jannis Leidel 
							
						 
					 
					
						
						
							
						
						52d72a5a3e 
					 
					
						
						
							
							Fixed   #17182  -- Changed best practice documentation for Form.clean to use super() instead of relying on self.cleaned_data. Thanks, DrMeers.  
						
						... 
						
						
						
						git-svn-id: http://code.djangoproject.com/svn/django/trunk@17433  bcc190cf-cafb-0310-a4f2-bffc1f526a37 
						
						
					 
					
						2012-02-04 16:05:30 +00:00 
						 
				 
			
				
					
						
							
							
								Luke Plant 
							
						 
					 
					
						
						
							
						
						d1e5c55258 
					 
					
						
						
							
							Fixed many more ReST indentation errors, somehow accidentally missed from [16955]  
						
						... 
						
						
						
						git-svn-id: http://code.djangoproject.com/svn/django/trunk@16983  bcc190cf-cafb-0310-a4f2-bffc1f526a37 
						
						
					 
					
						2011-10-14 00:12:01 +00:00 
						 
				 
			
				
					
						
							
							
								Simon Meers 
							
						 
					 
					
						
						
							
						
						5ecb88c146 
					 
					
						
						
							
							Fixed   #16014  -- numerous documentation typos -- thanks psmith.  
						
						... 
						
						
						
						git-svn-id: http://code.djangoproject.com/svn/django/trunk@16220  bcc190cf-cafb-0310-a4f2-bffc1f526a37 
						
						
					 
					
						2011-05-13 04:33:42 +00:00 
						 
				 
			
				
					
						
							
							
								Adrian Holovaty 
							
						 
					 
					
						
						
							
						
						9a279edc1c 
					 
					
						
						
							
							Fixed some ReST errors from e-mail -> email change in docs, and changed some docs that shouldn't have been changed (because translation strings haven't been converted yet)  
						
						... 
						
						
						
						git-svn-id: http://code.djangoproject.com/svn/django/trunk@15968  bcc190cf-cafb-0310-a4f2-bffc1f526a37 
						
						
					 
					
						2011-04-01 16:18:23 +00:00 
						 
				 
			
				
					
						
							
							
								Adrian Holovaty 
							
						 
					 
					
						
						
							
						
						94af19c43f 
					 
					
						
						
							
							Changed e-mail to email throughout documentation and codebase. The one exception is translation strings, which I didn't want to disrupt  
						
						... 
						
						
						
						git-svn-id: http://code.djangoproject.com/svn/django/trunk@15967  bcc190cf-cafb-0310-a4f2-bffc1f526a37 
						
						
					 
					
						2011-04-01 16:10:22 +00:00 
						 
				 
			
				
					
						
							
							
								Timo Graham 
							
						 
					 
					
						
						
							
						
						456534dda9 
					 
					
						
						
							
							Fixed   #15191  - typo in form validation docs; thanks berto for the report.  
						
						... 
						
						
						
						git-svn-id: http://code.djangoproject.com/svn/django/trunk@15372  bcc190cf-cafb-0310-a4f2-bffc1f526a37 
						
						
					 
					
						2011-01-30 19:09:44 +00:00 
						 
				 
			
				
					
						
							
							
								Luke Plant 
							
						 
					 
					
						
						
							
						
						c8bcd5e547 
					 
					
						
						
							
							Fixed   #14205  - Tiny grammar fix in form validation documentation  
						
						... 
						
						
						
						Thanks to zendak for report and patch.
git-svn-id: http://code.djangoproject.com/svn/django/trunk@13687  bcc190cf-cafb-0310-a4f2-bffc1f526a37 
						
						
					 
					
						2010-09-07 20:19:41 +00:00