Bug#169399: handling of additional documentation with doc-base

[Josip Rodin <joy@gkvk.hr>]

On Sat, Nov 16, 2002 at 08:26:19PM -0600, Manoj Srivastava wrote:
>  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). 

That seems logical, to document the API. (Even regardless of bugs in
install-docs, heh heh :)

I'll proofread it, perhaps reorganize it a little bit, and send it over for
comments.

-- 
     2. That which causes joy or happiness.