Browse Source

Fixed #30491 -- Clarified when save() on object with pk executes INSERT.

Brad Solomon 5 years ago
parent
commit
67b6cb7723
1 changed files with 2 additions and 1 deletions
  1. 2 1
      docs/ref/models/instances.txt

+ 2 - 1
docs/ref/models/instances.txt

@@ -472,7 +472,8 @@ follows this algorithm:
   ``True`` (i.e., a value other than ``None`` or the empty string), Django
   executes an ``UPDATE``.
 * If the object's primary key attribute is *not* set or if the ``UPDATE``
-  didn't update anything, Django executes an ``INSERT``.
+  didn't update anything (e.g. if primary key is set to a value that doesn't
+  exist in the database), Django executes an ``INSERT``.
 
 The one gotcha here is that you should be careful not to specify a primary-key
 value explicitly when saving new objects, if you cannot guarantee the