From e72fdc850a7c7703a5e019de127a4256bc136479 Mon Sep 17 00:00:00 2001 From: sandjio Date: Mon, 19 Feb 2024 18:24:23 +0100 Subject: [PATCH] [5.0.x] Fixed #35153 -- Added note about locale name notation to FORMAT_MODULE_PATH docs. Co-authored-by: Paul Hermans Backport of 9bd849c8d5c587209a231af643a17ec2db802ab2 from main --- docs/ref/settings.txt | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/docs/ref/settings.txt b/docs/ref/settings.txt index a7b789c3f6..48392d55a1 100644 --- a/docs/ref/settings.txt +++ b/docs/ref/settings.txt @@ -1728,6 +1728,10 @@ for project locales. If not ``None``, Django will check for a ``formats.py`` file, under the directory named as the current locale, and will use the formats defined in this file. +The name of the directory containing the format definitions is expected to be +named using :term:`locale name` notation, for example ``de``, ``pt_BR``, +``en_US``, etc. + For example, if :setting:`FORMAT_MODULE_PATH` is set to ``mysite.formats``, and current language is ``en`` (English), Django will expect a directory tree like: