| 1 | diff --git a/docs/ref/models/queries.txt b/docs/ref/models/queries.txt |
|---|
| 2 | index 1eab21c..c01bc79 100644 |
|---|
| 3 | --- a/docs/ref/models/queries.txt |
|---|
| 4 | +++ b/docs/ref/models/queries.txt |
|---|
| 5 | @@ -57,6 +57,18 @@ and describe the operation. |
|---|
| 6 | |
|---|
| 7 | reporter = Reporters.objects.get(pk=reporter.pk) |
|---|
| 8 | |
|---|
| 9 | +.. note:: |
|---|
| 10 | + |
|---|
| 11 | + The ``F()`` is applied everytime the ``save()`` method gets called. |
|---|
| 12 | + |
|---|
| 13 | + reporter.stories_filed = F('stories_filed') + 1 |
|---|
| 14 | + reporter.save() |
|---|
| 15 | + # other changes |
|---|
| 16 | + reporter.save() |
|---|
| 17 | + |
|---|
| 18 | + The above would cause ``reporter.stories_filed`` to be incrimented twice, |
|---|
| 19 | + once for each call to ``save()`` |
|---|
| 20 | + |
|---|
| 21 | As well as being used in operations on single instances as above, ``F()`` can |
|---|
| 22 | be used on ``QuerySets`` of object instances, with ``update()``. This reduces |
|---|
| 23 | the two queries we were using above - the ``get()`` and the |
|---|