diff options
| author | Tim Graham <timograham@gmail.com> | 2016-08-12 18:49:21 -0400 |
|---|---|---|
| committer | Tim Graham <timograham@gmail.com> | 2016-08-12 18:49:42 -0400 |
| commit | eea74edc7068a9c75f0f7b09ae59bfdcacc35195 (patch) | |
| tree | 959a6c8cc09eb2743dc4a0d15408dc2ecf37efb7 /docs | |
| parent | f8307c4b8cb0f8bfb16c8d819d16d90cfc763a29 (diff) | |
[1.10.x] Fixed #27048 -- Documented that refresh_from_db() doesn't reload @cached_properties.
Backport of 9556005425ca3d1c8c2a0e8b48e228e63a0bdd32 from master
Diffstat (limited to 'docs')
| -rw-r--r-- | docs/ref/models/instances.txt | 6 |
1 files changed, 4 insertions, 2 deletions
diff --git a/docs/ref/models/instances.txt b/docs/ref/models/instances.txt index 101e1d94a0..49f7184279 100644 --- a/docs/ref/models/instances.txt +++ b/docs/ref/models/instances.txt @@ -155,8 +155,10 @@ following is done: be thrown away, and when next accessed it will be reloaded with the value of ``obj.author_id``. -Note that only fields of the model are reloaded from the database. Other -database dependent values such as annotations are not reloaded. +Only fields of the model are reloaded from the database. Other +database-dependent values such as annotations aren't reloaded. Any +:func:`@cached_property <django.utils.functional.cached_property>` attributes +aren't cleared either. The reloading happens from the database the instance was loaded from, or from the default database if the instance wasn't loaded from the database. The |