reopen 153404 thanks Hi,
I don't fully understand your response.
On Fri, Jan 11, 2008 at 03:18:04PM +0000, Debian Bug Tracking System wrote:
> Subject: closing bug
> From: Vanessa Gutierrez <[EMAIL PROTECTED]>
> Reply-To: [EMAIL PROTECTED]
> To: [EMAIL PROTECTED]
> Date: Fri, 11 Jan 2008 10:41:32 -0430
>
> Package: apt-dpkg-ref
> Version: 5.2
>
> I didn't found a section called 'debian' in the Debian Policy Manual,
> this package belongs to the 'doc' section.
If you look at the Debian Policy Manual, section 9.10 (Registering
Documents using doc-base), you'll see:
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 via the install-docs script at
installation time and de-register the manuals again when the package
is removed.
Please refer to the documentation that comes with the doc-base
package for information and details.
So there is nothing in policy that describes the document sections.
Looking at doc-base docs, section 2.3.2.1 we find:
Section
Section where the document belongs; this should follow the
sections outlined in chapter 3.5 of "Debian Menu Policy", which
can be found in the /usr/share/doc/menu/html directory. Required
field.
Continuing on: we now need to look at the Debian Menu Policy to find
the section. The Debian Menu sub-policy, Chapter 2 has the menu
structure. As you suggest, there is no "Debian" section. However,
neither is there a "Doc" section!
It looks to me that the current situation does not follow the letter
of policy.
If we now ask "What documents are in section Doc", I find just
apt-dpkg-ref:
[EMAIL PROTECTED] 'Section:.*Doc' /usr/share/doc-base/*
/usr/share/doc-base/apt-dpkg-ref:Section: Docs
However, there are 31 packages in Section: Debian, including notables
such as Debian-Policy! More to the point, we also find apt-howto-en,
apt-offline-usage-guide, and apt-user-guie in section Debian. This to
me suggests that:
(1) apt-dpkg-ref should be moved, so I'm reopening this bug; and
(2) Doc-Base documentation has a bug in it.
Regards,
-Steve
signature.asc
Description: Digital signature
