Ticket #8419: doc-improvement.diff

File doc-improvement.diff, 995 bytes (added by Richard Davies <richard.davies@…>, 7 years ago)

Minor improvement to documentation of force_insert and force_update for save()

  • docs/ref/models/instances.txt

     
    205205the ``save()`` method. Passing both parameters is an error, since you cannot
    206206both insert *and* update at the same time.
    207207
    208 It should be very rare that you'll need to use these parameters. Django will
    209 almost always do the right thing and trying to override that will lead to
    210 errors that are difficult to track down. This feature is for advanced use
    211 only.
     208It should be very rare that you'll need to use these parameters - typically
     209only when your model does not have an ``AutoField`` primary key or when you
     210have explicitly specified the auto-primary-key value. Django will almost
     211always do the right thing and trying to override that will lead to errors
     212that are difficult to track down. This feature is for advanced use only.
    212213
    213214.. _model-instance-methods:
    214215
Back to Top