Sean Whitton <spwhit...@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 (r...@debian.org) <http://www.eyrie.org/~eagle/>
