Bug#910783: Remove doc-base recommendation
Sean Whitton <spwhitton@spwhitton.name> writes:
> Therefore I would like to propose the following change:
This looks good to me, and I agree that this thread has shown a consensus
that lack of doc-base registration should not be considered a bug, given
our belief that it is not widely used.
Seconded.
> diff --git a/policy/ch-customized-programs.rst b/policy/ch-customized-programs.rst
> index 529aa66..dbba4fc 100644
> --- a/policy/ch-customized-programs.rst
> +++ b/policy/ch-customized-programs.rst
> @@ -151,9 +151,8 @@ web servers and web applications in the Debian system.
>
> Web Applications should try to avoid storing files in the Web
> Document Root. Instead they should use the /usr/share/doc/package
> - directory for documents and register the Web Application via the
> - doc-base package. If access to the web document root is unavoidable
> - then use
> + directory for documents. If access to the web document root is
> + unavoidable then use
>
> ::
>
> diff --git a/policy/ch-opersys.rst b/policy/ch-opersys.rst
> index 6e0c020..fa1428f 100644
> --- a/policy/ch-opersys.rst
> +++ b/policy/ch-opersys.rst
> @@ -976,11 +976,11 @@ Here is an example of a wrapper script for this purpose:
> Registering Documents using doc-base
> ------------------------------------
>
> -The doc-base package implements a flexible mechanism for handling and
> -presenting documentation. The recommended practice is for every Debian
> -package that provides online documentation (other than just manual
> -pages) to register these documents with doc-base by installing a
> -doc-base control file in ``/usr/share/doc-base/``.
> +The doc-base package implements a mechanism for handling and
> +presenting documentation. Debian packages that provides online
> +documentation (other than just manual pages) may register these
> +documents with doc-base by installing a doc-base control file in
> +``/usr/share/doc-base/``.
>
> Please refer to the documentation that comes with the doc-base package
> for information and details.
--
Russ Allbery (rra@debian.org) <http://www.eyrie.org/~eagle/>
Reply to: