Recommend localized man pages be up-to-date or warn they're not

Based on a wording proposal by Helge Kreutzmann with additional
input from Christian Perrier, but with extensive rewording.

diff --git a/policy.sgml b/policy.sgml
index 43cf4d6d140de871594e292d315b69d67aa174f4..2843f1ddfa8409a8d87d648cf7f962bd29493ad7 100644 (file)
--- a/policy.sgml
+++ b/policy.sgml
@@ -8885,6 +8885,15 @@ name ["<var>syshostname</var>"]:
          characters outside that range may be found in
          <manref name="groff_char" section="7">.
        </p>
+
+       <p>
+         If a localized version of a manual page is provided, it should
+         either be up-to-date or it should be obvious to the reader that
+         it is outdated and the original manual page should be used
+         instead.  This can be done either by a note at the beginning of
+         the manual page or by showing the missing or changed portions in
+         the original language instead of the target language.
+       </p>
       </sect>
 
       <sect>