mirrors/django
1
0
Fork 0
mirror of https://github.com/django/django.git synced 2025-07-24 13:44:32 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 4

Added using to the list of documented arguments for save() on a model; updated the docs to suggest using `*args, **kwargs` when implementing model save methods. Thanks to Jeff Croft for the report.

Browse source 
git-svn-id: http://code.djangoproject.com/svn/django/trunk@12118 bcc190cf-cafb-0310-a4f2-bffc1f526a37
This commit is contained in:
Russell Keith-Magee 2010-01-08 00:17:33 +00:00
parent 47147071fe
commit 96848352f9
2 changed files with 42 additions and 20 deletions
Download patch file Download diff file Expand all files Collapse all files

36
docs/ref/models/instances.txt
View file

@ -66,15 +66,20 @@ Saving objects
To save an object back to the database, call ``save()``:
.. method:: Model.save([force_insert=False, force_update=False])
Of course, there are some subtleties; see the sections below.
.. method:: Model.save([force_insert=False, force_update=False, using=DEFAULT_DB_ALIAS])
.. versionadded:: 1.0
The ``force_insert`` and ``force_update`` arguments were added.
The signature of the ``save()`` method has changed from earlier versions
(``force_insert`` and ``force_update`` have been added). If you are overriding
these methods, be sure to use the correct signature.
.. versionadded:: 1.1
The ``using`` argument was added.
If you want customized saving behavior, you can override this
``save()`` method. See :ref:`overriding-model-methods` for more
details.
The model save process also has some subtleties; see the sections
below.
Auto-incrementing primary keys
------------------------------
@ -265,14 +270,21 @@ For more details, see the documentation on :ref:`F() expressions
Deleting objects
================
.. method:: Model.delete()
.. method:: Model.delete([using=DEFAULT_DB_ALIAS])
Issues a SQL ``DELETE`` for the object. This only deletes the object in the
database; the Python instance will still be around, and will still have data
in its fields.
.. versionadded:: 1.1
The ``using`` argument was added.
For more details, including how to delete objects in bulk, see
:ref:`topics-db-queries-delete`.
Issues a SQL ``DELETE`` for the object. This only deletes the object
in the database; the Python instance will still be around, and will
still have data in its fields.
For more details, including how to delete objects in bulk, see
:ref:`topics-db-queries-delete`.
If you want customized deletion behavior, you can override this
``delete()`` method. See :ref:`overriding-model-methods` for more
details.
.. _model-instance-methods: