Bug#463474: lintian: Please check doc-base Section field for allowed values
"Kevin B. McCarty" <kmccarty@debian.org> writes:
> According to the instructions shipped with the "doc-base" package, file
> /usr/share/doc/doc-base/doc-base.txt.gz , paragraph 2.3.2.1, the
> "Section" field in a doc-base file should use the Debian menu sections:
>
>> _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
>> (file:///usr/share/doc/menu/html/ch3.html#s3.5) directory.
>> Required field.
>
> Since the allowed menu sections have recently changed (and lintian now
> thoughtfully checks for this), it stands to reason that maintainers
> should also be reminded to change the Section fields in their doc-base
> files, ideally with the transition being completed pre-Lenny.
>
> Therefore, would it be possible to have Lintian run the same check on
> doc-base file Section fields as it does on menu file section fields? I
> know that this would certainly help me out!
>
> X-Debbugs-CC'ed to the doc-base maintainer in case he wants to comment.
> Note, if it was *not* the intention to have doc-base follow the menu
> policy transition, please reassign this bug to doc-base and retitle to
> "doc-base: should explicitly list allowed values for Section field".
The main reason why I didn't do this is that there was a lot of
controversy and discussion on debian-devel about using the menu categories
for doc-base recently, and I was wondering if that would reach some other
conclusion.
--
Russ Allbery (rra@debian.org) <http://www.eyrie.org/~eagle/>
Reply to: