[patch] update() method for model instances

[Gary Wilson <gary.wilson@…>]

Updating objects

The create(**kwargs) method is a convenience method for updating and saving an object all in one step. If we were to get an object:

p = Person.objects.get(pk=1)

Then, we could update the person's first and last name like so:

p.update(first_name="Bruce", last_name="Springsteen")

Note that this would be equivalent to the following:

p.first_name = "Bruce"
p.last_name = "Springsteen"
p.save()

The idea came from this discussion:

​http://groups.google.com/group/django-developers/browse_thread/thread/49a6b99dbcea4364/

[Gary Wilson <gary.wilson@…>]

update() method with documentation and tests

[Gary Wilson <gary.wilson@…>]

Actually, the "Updating objects" section I added to the docs should probably be integrated into the "Saving changes to objects" section.

[Gary Wilson <gary.wilson@…>]

documentation integrated into the "Saving changes to objects" section instead of creating a new section

[Jacob]

Superseded by #3182.