Bug#169399: handling of additional documentation with doc-base
>>"Josip" == Josip Rodin <joy@gkvk.hr> writes:
Josip> Surprisingly enough, we have yet to put any mention of
Josip> doc-base into the Policy. A lot of the packages that need it
Josip> use it by now[1], so it appears to be working properly. It
Josip> would be useful if it was "legalized" by the Policy Manual so
Josip> that new maintainers can't miss it for example, and that
Josip> existing maintainers can't ignore it saying "it's not in
Josip> Policy, so what if it's a good idea!".
If doc-base is really stable and working now, and if it is
deemed desirable to work it into policy, shouldn't the interface be,
umm legalized as well? If all packages that are installing
documentation are supposed to register with doc-base, then the
registration API should be in policy.
I suggest that /usr/share/doc/doc-base/doc-base.sgml be added
as a doc-base sub policy in the policy package itself, and using that
registration API be strongly recommended in the main policy
document (perhaps with a informative footnote that mentions that in
the future this recommendation may be converted into a requirement).
manoj
--
"We need a new cosmology. New Gods. New Sacraments. Another
drink." Patti Smith
Manoj Srivastava <srivasta@debian.org> <http://www.debian.org/%7Esrivasta/>
1024R/C7261095 print CB D9 F4 12 68 07 E4 05 CC 2D 27 12 1D F5 E8 6E
1024D/BF24424C print 4966 F272 D093 B493 410B 924B 21BA DABB BF24 424C
Reply to: