From: Russ Allbery <rra@debian.org>
Date: Sat, 20 Jun 2009 06:07:12 +0000 (-0700)
Subject: Recommend localized man pages be up-to-date or warn they're not
X-Git-Url: https://git.donarmstrong.com/?a=commitdiff_plain;h=b7fec0df34080c5558f691df5f9e58efa9c52661;p=debian%2Fdebian-policy.git

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 43cf4d6..2843f1d 100644
--- 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>