Refs #19221 -- Fixed outdated KEY_FUNCTION definition in docs/ref/settings.txt.

Replaced outdated version of `default_key_func` in settings reference
with pointer to current version in cache topic. Rewrote description to
match parameter order and behavior of default implementation.

Co-authored-by: nessita <124304+nessita@users.noreply.github.com>

1 files changed, 3 insertions, 8 deletions

diff --git a/docs/ref/settings.txt b/docs/ref/settings.txt
index fe3792bc5c..320ec7f83e 100644
--- a/docs/ref/settings.txt
+++ b/docs/ref/settings.txt
@@ -169,18 +169,13 @@ backend class (i.e. ``mypackage.backends.whatever.WhateverCache``).
 ~~~~~~~~~~~~~~~~
 
 A string containing a dotted path to a function (or any callable) that defines
-how to compose a prefix, version and key into a final cache key. The default
-implementation is equivalent to the function::
-
-    def make_key(key, key_prefix, version):
-        return ":".join([key_prefix, str(version), key])
+how to compose a key, prefix, and version into a final cache key. The default
+function converts the components to strings and joins them with colons, as
+shown in the :ref:`cache documentation <cache_key_transformation>`.
 
 You may use any key function you want, as long as it has the same
 argument signature.
 
-See the :ref:`cache documentation <cache_key_transformation>` for more
-information.
-
 .. setting:: CACHES-KEY_PREFIX
 
 ``KEY_PREFIX``