Seconded: Cyril Brulebois <kibi@debian.org>
Seconded: Steve Langasek <vorlon@debian.org>
Closes: #186102
+ * Policy: Require slave alternatives for manual pages
+ Wording: Russ Allbery <rra@debian.org>
+ Seconded: Guillem Jover <guillem@debian.org>
+ Seconded: Jakub Wilk <jwilk@debian.org>
+ Seconded: Emilio Pozuelo Monfort <pochu@debian.org>
+ Closes: #184064
* Set the version of the Perl Policy to match the version of the Policy
package.
* Explain the Perl module package naming policy more explicitly and
<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>
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>
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>
that libraries should be built with threading support and to be
thread-safe if the library supports this.
</item>
+<tag>11.4, 11.8.3, 11.8.4</tag>
+ <item>Packages providing alternatives for <prgn>editor</prgn>,
+ <prgn>pager</prgn>, <prgn>x-terminal-emulator</prgn>, or
+ <prgn>x-window-manager</prgn> should also provide a slave alternative
+ for the corresponding manual page.
+ </item>
<tag>11.5</tag>
<item>Cgi-bin executable files may be installed in subdirectories
of <file>/usr/lib/cgi-bin</file> and web servers should serve out