From 9556005425ca3d1c8c2a0e8b48e228e63a0bdd32 Mon Sep 17 00:00:00 2001 From: Tim Graham Date: Fri, 12 Aug 2016 18:49:21 -0400 Subject: [PATCH] Fixed #27048 -- Documented that refresh_from_db() doesn't reload @cached_properties. --- docs/ref/models/instances.txt | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/docs/ref/models/instances.txt b/docs/ref/models/instances.txt index f0decc28d8..514b470b15 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 ` 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