[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

Bug#160248: section 13.3 unnecessarily obscure



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

Attachment: pgpUdTTb9MXRJ.pgp
Description: PGP signature


Reply to: