From ddd9272c2e323b4e8937774425ee93ebebf8eeba Mon Sep 17 00:00:00 2001
From: Jeffrey Yancey <jeffrey.yancey@gmail.com>
Date: Thu, 28 Jun 2018 14:39:42 -0400
Subject: [PATCH] [2.1.x] Fixed #29458 -- Doc'd how related_query_name affects
Model._meta.get_field().
Backport of 2d6776ffe0b58f729f4372635b49a59da99ca206 from master
---
AUTHORS | 1 +
docs/ref/models/meta.txt | 5 +++--
2 files changed, 4 insertions(+), 2 deletions(-)
diff --git a/AUTHORS b/AUTHORS
index 4ac99db75e..8319e84ece 100644
--- a/AUTHORS
+++ b/AUTHORS
@@ -381,6 +381,7 @@ answer newbie questions, and generally made Django that much better:
Jeff Hui <jeffkhui@gmail.com>
Jeffrey Gelens <jeffrey@gelens.org>
Jeff Triplett <jeff.triplett@gmail.com>
+ Jeffrey Yancey <jeffrey.yancey@gmail.com>
Jens Diemer <django@htfx.de>
Jens Page
Jensen Cochran <jensen.cochran@gmail.com>
diff --git a/docs/ref/models/meta.txt b/docs/ref/models/meta.txt
index b63305d427..8adf719e16 100644
--- a/docs/ref/models/meta.txt
+++ b/docs/ref/models/meta.txt
@@ -33,8 +33,9 @@ Retrieving a single field instance of a model by name
``field_name`` can be the name of a field on the model, a field
on an abstract or inherited model, or a field defined on another
model that points to the model. In the latter case, the ``field_name``
- will be the ``related_name`` defined by the user or the name automatically
- generated by Django itself.
+ will be (in order of preference) the :attr:`~.ForeignKey.related_query_name`
+ set by the user, the :attr:`~.ForeignKey.related_name` set by the user, or
+ the name automatically generated by Django.
:attr:`Hidden fields <django.db.models.Field.hidden>` cannot be retrieved
by name.