From 903e3e70e08c1500a11d6d069c8e833f8d8dda23 Mon Sep 17 00:00:00 2001
From: Russ Allbery <rra@debian.org>
Date: Sat, 17 Jul 2010 18:33:18 -0700
Subject: [PATCH] Alternatives should have slave alternatives for manual pages

Require that the alternatives for editor, pager, x-terminal-emulator,
and x-window-manager have slave alternatives pointing to the appropriate
manual page.
---
 policy.sgml | 19 ++++++++++++++-----
 1 file changed, 14 insertions(+), 5 deletions(-)

diff --git a/policy.sgml b/policy.sgml
index 0b3c1a1..029a34c 100644
--- a/policy.sgml
+++ b/policy.sgml
@@ -8273,10 +8273,14 @@ done
 
 	<p>
 	  These two files are managed through the <prgn>dpkg</prgn>
-	  "alternatives" mechanism.  Thus every package providing an
-	  editor or pager must call the
-	  <prgn>update-alternatives</prgn> script to register these
-	  programs.
+	  "alternatives" mechanism.  Every package providing an editor or
+	  pager must call the <prgn>update-alternatives</prgn> script to
+	  register as an alternative for <file>/usr/bin/editor</file>
+	  or <file>/usr/bin/pager</file> as appropriate.  The alternative
+	  should have a slave alternative
+	  for <file>/usr/share/man/man1/editor.1.gz</file>
+	  or <file>/usr/share/man/man1/pager.1.gz</file> pointing to the
+	  corresponding manual page.
 	</p>
 
 	<p>
@@ -8621,7 +8625,9 @@ name ["<var>syshostname</var>"]:
 	    package <tt>x-terminal-emulator</tt>.  They should also
 	    register themselves as an alternative for
 	    <file>/usr/bin/x-terminal-emulator</file>, with a priority of
-	    20.
+	    20.  That alternative should have a slave alternative
+	    for <file>/usr/share/man/man1/x-terminal-emulator.1.gz</file>
+	    pointing to the corresponding manual page.
 	  </p>
 
 	  <p>
@@ -8698,6 +8704,9 @@ name ["<var>syshostname</var>"]:
 		  configuration, add 10 points; otherwise add none.
 	      </item>
 	    </list>
+	    That alternative should have a slave alternative
+	    for <file>/usr/share/man/man1/x-window-manager.1.gz</file>
+	    pointing to the corresponding manual page.
 	  </p>
 	</sect1>
 
-- 
2.39.5