summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorsebashwa <sebashwa@mailbox.org>2020-06-12 15:29:13 +0200
committerMariusz Felisiak <felisiak.mariusz@gmail.com>2020-06-15 07:58:47 +0200
commit3d664a158de18acf72fc8e0671f0f390cbca4b2e (patch)
tree3fb80585937d996ddde3daf4f92d6d7abbc7b73b
parent6b25d24a5755bb90c037e2afd485668bae8f179e (diff)
Fixed #31690 -- Added note about fuzzy entries in translation docs.
-rw-r--r--docs/ref/django-admin.txt4
-rw-r--r--docs/topics/i18n/translation.txt7
2 files changed, 10 insertions, 1 deletions
diff --git a/docs/ref/django-admin.txt b/docs/ref/django-admin.txt
index f67849c848..b0913becf0 100644
--- a/docs/ref/django-admin.txt
+++ b/docs/ref/django-admin.txt
@@ -160,7 +160,7 @@ are excluded.
.. django-admin-option:: --use-fuzzy, -f
-Includes fuzzy translations into compiled files.
+Includes `fuzzy translations`_ into compiled files.
Example usage::
@@ -173,6 +173,8 @@ Example usage::
django-admin compilemessages -x pt_BR
django-admin compilemessages -x pt_BR -x fr
+.. _fuzzy translations: https://www.gnu.org/software/gettext/manual/html_node/Fuzzy-Entries.html
+
.. django-admin-option:: --ignore PATTERN, -i PATTERN
Ignores directories matching the given :mod:`glob`-style pattern. Use
diff --git a/docs/topics/i18n/translation.txt b/docs/topics/i18n/translation.txt
index 7afe47c149..1fa2c7e711 100644
--- a/docs/topics/i18n/translation.txt
+++ b/docs/topics/i18n/translation.txt
@@ -1619,6 +1619,13 @@ otherwise, they'll be tacked together without whitespace!
files are created). This means that everybody will be using the same
encoding, which is important when Django processes the PO files.
+.. admonition:: Fuzzy entries
+
+ :djadmin:`makemessages` sometimes generates translation entries marked as
+ fuzzy, e.g. when translations are inferred from previously translated
+ strings. By default, fuzzy entries are **not** processed by
+ :djadmin:`compilemessages`.
+
To reexamine all source code and templates for new translation strings and
update all message files for **all** languages, run this::