On Tue, Sep 10, 2002 at 01:10:18PM +1000, Anthony Towns wrote: > On Mon, Sep 09, 2002 at 07:20:14PM +0100, Andrew Suffield wrote: > > + The system administrator should be able to delete files in > > + `/usr/share/doc' without causing any programs to break. A package > > + should not directly reference files that it places there. > > Sure it should: ``further documentation may be found in > /usr/share/doc/foo''. Better would probably be to say "A package should > not require the existance of any files in /usr/share/doc to run." Which > is pretty much repeating yourself, if that matters.
Argh. That's what I get for trying to maintain the original content as
much as possible. Might as well just delete the wretched sentance
entirely; rereading it, I can't see it saying anything useful.
need to install the instructions for building and installing the
package, of course!
- Files in `/usr/share/doc' should not be referenced by any program, and
- the system administrator should be able to delete them without causing
- any programs to break. Any files that are referenced by programs but
- are also useful as standalone documentation should be installed under
- `/usr/share/<package>/' with symbolic links from
- `/usr/share/doc/<package>/'.
+ The system administrator should be able to delete files in
+ `/usr/share/doc' without causing any programs to break. Any files
+ that are referenced by programs but are also useful as standalone
+ documentation should be installed under `/usr/share/<package>/'
+ with symbolic links from `/usr/share/doc/<package>/'.
--
.''`. ** Debian GNU/Linux ** | Andrew Suffield
: :' : http://www.debian.org/ | Dept. of Computing,
`. `' | Imperial College,
`- -><- | London, UK
pgpSiQ2Z23epa.pgp
Description: PGP signature

