From 6d504562f5f27698a668759254101290b82e89b9 Mon Sep 17 00:00:00 2001 From: Andrew Godwin Date: Fri, 5 Sep 2014 11:38:44 -0700 Subject: [PATCH] Fixed #22534: Reinforce swappable documentation --- docs/ref/models/fields.txt | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/docs/ref/models/fields.txt b/docs/ref/models/fields.txt index d7f15d6643..1f96a72323 100644 --- a/docs/ref/models/fields.txt +++ b/docs/ref/models/fields.txt @@ -1260,6 +1260,12 @@ The possible values for :attr:`~ForeignKey.on_delete` are found in model should always point towards the swapped-in model - for example, if it is a profile model designed specifically for your custom user model. + Setting it to ``False`` does not mean you can reference a swappable model + even if it is swapped out - ``False`` just means that the migrations made + with this ForeignKey will always reference the exact model you specify + (so it will fail hard if the user tries to run with a User model you don't + support, for example). + If in doubt, leave it to its default of ``True``. .. _ref-manytomany: