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::