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
numbers based on some date formats (sometimes used for
development or "snapshot" releases) will not be ordered
correctly by the package management software. For
- example, <prng>dpkg</prng> will consider "96May01" to be
+ example, <prgn>dpkg</prgn> will consider "96May01" to be
greater than "96Dec24".
</p>
<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>
virtual 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