Ryan Heard 
							
						 
					 
					
						
						
							
						
						587b179d41 
					 
					
						
						
							
							Fixed   #31606  -- Allowed using condition with lookups in When() expression.  
						
						
						
						
					 
					
						2020-05-27 07:32:23 +02:00 
						 
				 
			
				
					
						
							
							
								Manuel Weitzman 
							
						 
					 
					
						
						
							
						
						a4e6030904 
					 
					
						
						
							
							Fixed   #30375  -- Added FOR NO KEY UPDATE support to QuerySet.select_for_update() on PostgreSQL.  
						
						
						
						
					 
					
						2020-05-21 10:51:10 +02:00 
						 
				 
			
				
					
						
							
							
								Mariusz Felisiak 
							
						 
					 
					
						
						
							
						
						4c5236ef93 
					 
					
						
						
							
							Removed versionadded/changed annotations for 3.0.  
						
						
						
						
					 
					
						2020-05-13 09:07:51 +02:00 
						 
				 
			
				
					
						
							
							
								sage 
							
						 
					 
					
						
						
							
						
						6789ded0a6 
					 
					
						
						
							
							Fixed   #12990 , Refs  #27694  -- Added JSONField model field.  
						
						... 
						
						
						
						Thanks to Adam Johnson, Carlton Gibson, Mariusz Felisiak, and Raphael
Michel for mentoring this Google Summer of Code 2019 project and
everyone else who helped with the patch.
Special thanks to Mads Jensen, Nick Pope, and Simon Charette for
extensive reviews.
Co-authored-by: Mariusz Felisiak <felisiak.mariusz@gmail.com > 
						
						
					 
					
						2020-05-08 07:23:31 +02:00 
						 
				 
			
				
					
						
							
							
								Adam Johnson 
							
						 
					 
					
						
						
							
						
						83c631ade7 
					 
					
						
						
							
							Improved wording in Q() docs.  
						
						
						
						
					 
					
						2020-05-06 06:43:28 +02:00 
						 
				 
			
				
					
						
							
							
								Adam Johnson 
							
						 
					 
					
						
						
							
						
						1c2c6f1b51 
					 
					
						
						
							
							Fixed a/an typos in "SQL" usage.  
						
						
						
						
					 
					
						2020-05-06 06:35:26 +02:00 
						 
				 
			
				
					
						
							
							
								Adam Johnson 
							
						 
					 
					
						
						
							
						
						d17b380653 
					 
					
						
						
							
							Refs  #30573  -- Rephrased "Of Course" and "Obvious(ly)" in documentation and comments.  
						
						
						
						
					 
					
						2020-05-04 12:10:47 +02:00 
						 
				 
			
				
					
						
							
							
								Adam Johnson 
							
						 
					 
					
						
						
							
						
						787981f9d1 
					 
					
						
						
							
							Corrected models.FilePathField signature in docs.  
						
						
						
						
					 
					
						2020-05-04 12:10:41 +02:00 
						 
				 
			
				
					
						
							
							
								Ian Foote 
							
						 
					 
					
						
						
							
						
						c226c6cb32 
					 
					
						
						
							
							Fixed   #20581  -- Added support for deferrable unique constraints.  
						
						
						
						
					 
					
						2020-04-30 10:43:50 +02:00 
						 
				 
			
				
					
						
							
							
								Hasan Ramezani 
							
						 
					 
					
						
						
							
						
						d6db186427 
					 
					
						
						
							
							Fixed   #31514  -- Fixed default form widgets in model fields docs.  
						
						
						
						
					 
					
						2020-04-25 21:20:29 +02:00 
						 
				 
			
				
					
						
							
							
								Tim Schilling 
							
						 
					 
					
						
						
							
						
						a92cc84b4a 
					 
					
						
						
							
							Refs  #31369  -- Deprecated models.NullBooleanField in favor of BooleanField(null=True).  
						
						
						
						
					 
					
						2020-04-24 10:10:45 +02:00 
						 
				 
			
				
					
						
							
							
								Mariusz Felisiak 
							
						 
					 
					
						
						
							
						
						cc70a0343e 
					 
					
						
						
							
							Fixed term warning on Sphinx 3.0.1+.  
						
						... 
						
						
						
						"term" role became case sensitive in Sphinx 3.0.1. 
						
						
					 
					
						2020-04-14 09:32:09 +02:00 
						 
				 
			
				
					
						
							
							
								miigotu 
							
						 
					 
					
						
						
							
						
						210657b791 
					 
					
						
						
							
							Fixed   #28184  -- Allowed using a callable for FileField and ImageField storage.  
						
						
						
						
					 
					
						2020-04-08 11:26:17 +02:00 
						 
				 
			
				
					
						
							
							
								Mariusz Felisiak 
							
						 
					 
					
						
						
							
						
						69e2cd6fed 
					 
					
						
						
							
							Fixed Sphinx warnings on duplicate object descriptions.  
						
						
						
						
					 
					
						2020-04-07 09:48:52 +02:00 
						 
				 
			
				
					
						
							
							
								Adam Johnson 
							
						 
					 
					
						
						
							
						
						1cdfe8d912 
					 
					
						
						
							
							Prevented (and corrected) single backtick usage in docs.  
						
						
						
						
					 
					
						2020-04-01 14:55:11 +02:00 
						 
				 
			
				
					
						
							
							
								Adam Johnson 
							
						 
					 
					
						
						
							
						
						93ed71e058 
					 
					
						
						
							
							Fixed   #31403  -- Added support for returning fields from INSERT statements on MariaDB 10.5+.  
						
						
						
						
					 
					
						2020-03-31 07:25:50 +02:00 
						 
				 
			
				
					
						
							
							
								Hasan Ramezani 
							
						 
					 
					
						
						
							
						
						53b6a466d8 
					 
					
						
						
							
							Refs  #29724  -- Added is_dst parameter to QuerySet.datetimes().  
						
						... 
						
						
						
						Thanks Simon Charette for the review and Mariusz Felisiak for tests. 
						
						
					 
					
						2020-03-20 12:55:33 +01:00 
						 
				 
			
				
					
						
							
							
								Hasan Ramezani 
							
						 
					 
					
						
						
							
						
						6929f13254 
					 
					
						
						
							
							Fixed   #31368  -- Doc'd 'expression' parameter of Field.from_db_value()/Expression.convert_value().  
						
						
						
						
					 
					
						2020-03-18 09:37:05 +01:00 
						 
				 
			
				
					
						
							
							
								Adam Johnson 
							
						 
					 
					
						
						
							
						
						8c1b073b59 
					 
					
						
						
							
							Doc'd return values of as_sql() for Func and query expressions.  
						
						
						
						
					 
					
						2020-03-06 13:02:08 +01:00 
						 
				 
			
				
					
						
							
							
								Mariusz Felisiak 
							
						 
					 
					
						
						
							
						
						30ca66eadd 
					 
					
						
						
							
							Added missing backticks in various docs.  
						
						
						
						
					 
					
						2020-03-06 11:52:49 +01:00 
						 
				 
			
				
					
						
							
							
								Andrey Doroschenko 
							
						 
					 
					
						
						
							
						
						f1016814d8 
					 
					
						
						
							
							Fixed   #31313  -- Fixed is_upperclass() example in enumeration types docs.  
						
						
						
						
					 
					
						2020-02-27 08:33:05 +01:00 
						 
				 
			
				
					
						
							
							
								Carlton Gibson 
							
						 
					 
					
						
						
							
						
						3bbf9a489a 
					 
					
						
						
							
							Fixed   #31282  -- Corrected RelatedManager docs for using add/remove/set with PKs.  
						
						
						
						
					 
					
						2020-02-18 19:54:29 +01:00 
						 
				 
			
				
					
						
							
							
								Adam Johnson 
							
						 
					 
					
						
						
							
						
						382af9b141 
					 
					
						
						
							
							Fixed   #31003  -- Doc'd and tested return value of QuerySet.bulk_create().  
						
						
						
						
					 
					
						2020-02-10 08:36:50 +01:00 
						 
				 
			
				
					
						
							
							
								Claude Paroz 
							
						 
					 
					
						
						
							
						
						c7b97ac3a7 
					 
					
						
						
							
							Added missing backtick in instances docs.  
						
						
						
						
					 
					
						2020-01-17 20:26:36 +01:00 
						 
				 
			
				
					
						
							
							
								Carlton Gibson 
							
						 
					 
					
						
						
							
						
						29c126bb34 
					 
					
						
						
							
							Fixed   #31124  -- Fixed setting of get_FOO_display() when overriding inherited choices.  
						
						... 
						
						
						
						Regression in 2d38eb0ab9 
						
						
					 
					
						2020-01-15 15:35:22 +01:00 
						 
				 
			
				
					
						
							
							
								Simon Charette 
							
						 
					 
					
						
						
							
						
						9e14bc2135 
					 
					
						
						
							
							Refs  #29260  -- Doc'd Model.save() behavior change in Django 3.0.  
						
						
						
						
					 
					
						2019-12-30 07:49:10 +01:00 
						 
				 
			
				
					
						
							
							
								Taoup 
							
						 
					 
					
						
						
							
						
						cebd41e416 
					 
					
						
						
							
							Fixed   #31110  -- Fixed typo in docs/ref/models/expressions.txt.  
						
						
						
						
					 
					
						2019-12-21 20:33:04 +01:00 
						 
				 
			
				
					
						
							
							
								Baptiste Mispelon 
							
						 
					 
					
						
						
							
						
						26cab4e8c1 
					 
					
						
						
							
							Fixed   #31046  -- Allowed RelatedManager.add()/create()/set() to accept callable values in through_defaults.  
						
						
						
						
					 
					
						2019-12-03 19:47:38 +01:00 
						 
				 
			
				
					
						
							
							
								Mariusz Felisiak 
							
						 
					 
					
						
						
							
						
						0107e3d105 
					 
					
						
						
							
							Fixed   #30953  -- Made select_for_update() lock queryset's model when using "self" with multi-table inheritance.  
						
						... 
						
						
						
						Thanks Abhijeet Viswa for the report and initial patch. 
						
						
					 
					
						2019-12-02 07:57:19 +01:00 
						 
				 
			
				
					
						
							
							
								Baptiste Mispelon 
							
						 
					 
					
						
						
							
						
						ff1b19da67 
					 
					
						
						
							
							Fixed   #31029  -- Used more specific links to RFCs.  
						
						
						
						
					 
					
						2019-11-27 20:54:38 +01:00 
						 
				 
			
				
					
						
							
							
								Simon Charette 
							
						 
					 
					
						
						
							
						
						e9a0e1d4f6 
					 
					
						
						
							
							Fixed   #30484  -- Added conditional expressions support to CheckConstraint.  
						
						
						
						
					 
					
						2019-11-21 11:56:35 +01:00 
						 
				 
			
				
					
						
							
							
								Daniel Izquierdo 
							
						 
					 
					
						
						
							
						
						89abecc75d 
					 
					
						
						
							
							Fixed   #27272  -- Added an on_delete RESTRICT handler to allow cascading deletions while protecting direct ones.  
						
						
						
						
					 
					
						2019-11-19 10:55:05 +01:00 
						 
				 
			
				
					
						
							
							
								Caio Ariede 
							
						 
					 
					
						
						
							
						
						555bebe774 
					 
					
						
						
							
							Fixed   #30987  -- Added models.PositiveBigIntegerField.  
						
						
						
						
					 
					
						2019-11-19 09:34:11 +01:00 
						 
				 
			
				
					
						
							
							
								Farhaan Bukhsh 
							
						 
					 
					
						
						
							
						
						4cb15450ad 
					 
					
						
						
							
							Fixed   #30958  -- Used a clearer example in the Cast() docs.  
						
						
						
						
					 
					
						2019-11-11 09:42:53 +01:00 
						 
				 
			
				
					
						
							
							
								Hasan Ramezani 
							
						 
					 
					
						
						
							
						
						153c7956f8 
					 
					
						
						
							
							Fixed   #24858  -- Added support for get_FOO_display() to ArrayField and RangeFields.  
						
						... 
						
						
						
						_get_FIELD_display() crashed when Field.choices was unhashable. 
						
						
					 
					
						2019-11-08 10:59:24 +01:00 
						 
				 
			
				
					
						
							
							
								kola-er 
							
						 
					 
					
						
						
							
						
						d94d7b113c 
					 
					
						
						
							
							Fixed   #30928  -- Clarified MySQL/MariaDB support of QuerySet.select_for_update() options.  
						
						... 
						
						
						
						Thanks Par Andersson for reporting the issue. 
						
						
					 
					
						2019-11-05 14:34:40 +01:00 
						 
				 
			
				
					
						
							
							
								Carlton Gibson 
							
						 
					 
					
						
						
							
						
						cabf1fe37e 
					 
					
						
						
							
							Refs  #30897  -- Made cosmetic edits to QuerySet.explain() documentation.  
						
						
						
						
					 
					
						2019-10-24 15:16:25 +02:00 
						 
				 
			
				
					
						
							
							
								Nick Pope 
							
						 
					 
					
						
						
							
						
						55df1750be 
					 
					
						
						
							
							Refs  #30897  -- Added support for ANALYZE option to Queryset.explain() on MariaDB and MySQL 8.0.18+.  
						
						
						
						
					 
					
						2019-10-24 15:13:26 +02:00 
						 
				 
			
				
					
						
							
							
								Nick Pope 
							
						 
					 
					
						
						
							
						
						742961332e 
					 
					
						
						
							
							Refs  #30897  -- Added support for TREE format to Queryset.explain() on MySQL 8.0.16+.  
						
						
						
						
					 
					
						2019-10-24 15:13:23 +02:00 
						 
				 
			
				
					
						
							
							
								Antonio Dudarev 
							
						 
					 
					
						
						
							
						
						6c23b43655 
					 
					
						
						
							
							Refs  #13724  -- Corrected QuerySet signature in docs.  
						
						
						
						
					 
					
						2019-10-22 14:23:21 +02:00 
						 
				 
			
				
					
						
							
							
								André Ericson 
							
						 
					 
					
						
						
							
						
						31174031f1 
					 
					
						
						
							
							Fixed   #30841  -- Deprecated using non-boolean values for isnull lookup.  
						
						
						
						
					 
					
						2019-10-21 08:44:20 +02:00 
						 
				 
			
				
					
						
							
							
								Anatol Ulrich 
							
						 
					 
					
						
						
							
						
						8ed6788aa4 
					 
					
						
						
							
							Fixed   #30821  -- Added ExtractIsoWeekYear database function and iso_week_day lookup.  
						
						
						
						
					 
					
						2019-10-02 10:41:34 +02:00 
						 
				 
			
				
					
						
							
							
								Mariusz Felisiak 
							
						 
					 
					
						
						
							
						
						e1aa932802 
					 
					
						
						
							
							Added missing import in ref/models/database-functions.txt.  
						
						
						
						
					 
					
						2019-10-02 09:58:14 +02:00 
						 
				 
			
				
					
						
							
							
								Mariusz Felisiak 
							
						 
					 
					
						
						
							
						
						343afa7880 
					 
					
						
						
							
							Refs  #29915  -- Doc'd limitation of using pattern lookups with UUIDField on PostgreSQL.  
						
						
						
						
					 
					
						2019-09-23 08:24:00 +02:00 
						 
				 
			
				
					
						
							
							
								Claude Paroz 
							
						 
					 
					
						
						
							
						
						b8dff52f44 
					 
					
						
						
							
							Fixed   #29823  -- Doc'd limitation of DecimalField on SQLite.  
						
						
						
						
					 
					
						2019-09-14 17:10:08 +02:00 
						 
				 
			
				
					
						
							
							
								Nick Pope 
							
						 
					 
					
						
						
							
						
						1c66767d4e 
					 
					
						
						
							
							Refs  #27910  -- Improved documentation for model field choice enumeration types.  
						
						
						
						
					 
					
						2019-09-13 15:37:40 +02:00 
						 
				 
			
				
					
						
							
							
								Mariusz Felisiak 
							
						 
					 
					
						
						
							
						
						0ddb4ebf7b 
					 
					
						
						
							
							Refs  #14357  -- Made Meta.ordering not affect GROUP BY queries.  
						
						... 
						
						
						
						Per deprecation timeline. 
						
						
					 
					
						2019-09-10 12:01:00 +02:00 
						 
				 
			
				
					
						
							
							
								Mariusz Felisiak 
							
						 
					 
					
						
						
							
						
						416c584cab 
					 
					
						
						
							
							Removed versionadded/changed annotations for 2.2.  
						
						
						
						
					 
					
						2019-09-10 12:01:00 +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 
						 
				 
			
				
					
						
							
							
								Shai Berger 
							
						 
					 
					
						
						
							
						
						72ebe85a26 
					 
					
						
						
							
							Fixed   #27910  -- Added enumeration helpers for use in Field.choices.  
						
						... 
						
						
						
						These classes can serve as a base class for user enums, supporting
translatable human-readable names, or names automatically inferred
from the enum member name.
Additional properties make it easy to access the list of names, values
and display labels.
Thanks to the following for ideas and reviews:
Carlton Gibson, Fran Hrženjak, Ian Foote, Mariusz Felisiak, Shai Berger.
Co-authored-by: Shai Berger <shai@platonix.com >
Co-authored-by: Nick Pope <nick.pope@flightdataservices.com >
Co-authored-by: Mariusz Felisiak <felisiak.mariusz@gmail.com > 
						
						
					 
					
						2019-09-04 14:42:49 +02:00