Browse Source

Fixed #28403 -- Added missing formats in FORMAT_MODULE_PATH docs.

Ashaba 7 years ago
parent
commit
95fd5cf459
2 changed files with 22 additions and 8 deletions
  1. 18 8
      docs/ref/settings.txt
  2. 4 0
      docs/topics/i18n/translation.txt

+ 18 - 8
docs/ref/settings.txt

@@ -1577,8 +1577,8 @@ render API <low-level-widget-render-api>`.
 
 Default: ``None``
 
-A full Python path to a Python package that contains format definitions for
-project locales. If not ``None``, Django will check for a ``formats.py``
+A full Python path to a Python package that contains custom format definitions
+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.
 
@@ -1605,12 +1605,22 @@ paths until it finds a module that actually defines the given format. This
 means that formats defined in packages farther up in the list will take
 precedence over the same formats in packages farther down.
 
-Available formats are :setting:`DATE_FORMAT`, :setting:`TIME_FORMAT`,
-:setting:`DATETIME_FORMAT`, :setting:`YEAR_MONTH_FORMAT`,
-:setting:`MONTH_DAY_FORMAT`, :setting:`SHORT_DATE_FORMAT`,
-:setting:`SHORT_DATETIME_FORMAT`, :setting:`FIRST_DAY_OF_WEEK`,
-:setting:`DECIMAL_SEPARATOR`, :setting:`THOUSAND_SEPARATOR` and
-:setting:`NUMBER_GROUPING`.
+Available formats are:
+
+* :setting:`DATE_FORMAT`
+* :setting:`DATE_INPUT_FORMATS`
+* :setting:`DATETIME_FORMAT`,
+* :setting:`DATETIME_INPUT_FORMATS`
+* :setting:`DECIMAL_SEPARATOR`
+* :setting:`FIRST_DAY_OF_WEEK`
+* :setting:`MONTH_DAY_FORMAT`
+* :setting:`NUMBER_GROUPING`
+* :setting:`SHORT_DATE_FORMAT`
+* :setting:`SHORT_DATETIME_FORMAT`
+* :setting:`THOUSAND_SEPARATOR`
+* :setting:`TIME_FORMAT`
+* :setting:`TIME_INPUT_FORMATS`
+* :setting:`YEAR_MONTH_FORMAT`
 
 .. setting:: IGNORABLE_404_URLS
 

+ 4 - 0
docs/topics/i18n/translation.txt

@@ -2076,6 +2076,10 @@ translations for the same literal:
     following a similar but not identical algorithm. See
     :class:`.JavaScriptCatalog` for more details.
 
+    You can also put :ref:`custom format files <custom-format-files>` in the
+    :setting:`LOCALE_PATHS` directories if you also set
+    :setting:`FORMAT_MODULE_PATH`.
+
 In all cases the name of the directory containing the translation is expected to
 be named using :term:`locale name` notation. E.g. ``de``, ``pt_BR``, ``es_AR``,
 etc.