From 9bd849c8d5c587209a231af643a17ec2db802ab2 Mon Sep 17 00:00:00 2001 From: sandjio Date: Mon, 19 Feb 2024 18:24:23 +0100 Subject: [PATCH] Fixed #35153 -- Added note about locale name notation to FORMAT_MODULE_PATH docs. Co-authored-by: Paul Hermans --- docs/ref/settings.txt | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/docs/ref/settings.txt b/docs/ref/settings.txt index 98434c8833..242cf31e9f 100644 --- a/docs/ref/settings.txt +++ b/docs/ref/settings.txt @@ -1710,6 +1710,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: