Re: In-Program documentation

["Nelson A. de Oliveira" <naoliv@gmail.com>]

Hi!

On 9/4/07, Jörg Sommer <joerg@alea.gnuu.de> wrote:
> Justin Pryzby <jpryzby+d@quoininc.com> wrote:
> > It's a little known requirement that packages continue to work after
> > /u/s/doc is removed.  So it's not allowed to install required files
> > there.  You could do (2) or (3) with links *from* u/s/d though.
>
> Where's this written? In the policy?

Debian Policy section 12.3:

(...)
Packages must not require the existence of any files in
/usr/share/doc/ in order to function [78]. Any files that are
referenced by programs but are also useful as stand alone
documentation should be installed under /usr/share/package/ with
symbolic links from /usr/share/doc/package.
(...)

Note [78]: The system administrator should be able to delete files in
/usr/share/doc/ without causing any programs to break.

So yes, people can remove /usr/share/doc and the program needs to keep
working properly.

Best regards,
Nelson