Announce upcoming fix for the localization of the "admonition" directive name.

git-svn-id: https://svn.code.sf.net/p/docutils/code/trunk@9383 929543f6-e4f2-0310-98a6-ba3bd3dd1d04

2 files changed, 11 insertions, 0 deletions

diff --git a/docutils/RELEASE-NOTES.txt b/docutils/RELEASE-NOTES.txt
index 26492a953..1b1347974 100644
--- a/docutils/RELEASE-NOTES.txt
+++ b/docutils/RELEASE-NOTES.txt
@@ -183,6 +183,15 @@ Misc
 
   __ docs/ref/transforms.html
 
+* docutils/parsers/rst/languages/
+
+  Fix mistranslated localizations of the "admonition" directive name in
+  Docutils 0.21 (or later). In Docutils, "admonition" is used as a
+  generic term for "advice"/"caveat"/"remark", not a reprimand.
+  Use the English term (or specific admonitions) instead of "aanmaning",
+  "ammonizione", "Ermahnung", "exhortacion", "formaning", "upomnienie",
+  or "vermaning" to avoid errors in future conversions.
+
 .. _front end tools: docs/user/tools.html
 .. _input encoding:
 .. _input_encoding: docs/user/config.html#input-encoding
diff --git a/docutils/docutils/parsers/rst/languages/fr.py b/docutils/docutils/parsers/rst/languages/fr.py
index 18811d08b..a77400aac 100644
--- a/docutils/docutils/parsers/rst/languages/fr.py
+++ b/docutils/docutils/parsers/rst/languages/fr.py
@@ -26,6 +26,8 @@ directives = {
       'astuce': 'tip',
       'avertissement': 'warning',
       'admonition': 'admonition',  # sic! Not used in this sense in rST.
+      # suggestions: annonce, avis, indication, remarque, renseignement
+      # see also https://sourceforge.net/p/docutils/bugs/453/
       'encadré': 'sidebar',
       'sujet': 'topic',
       'bloc-textuel': 'line-block',