Re: Bug#160248: section 13.3 unnecessarily obscure
>>"Andrew" == Andrew Suffield <asuffield@debian.org> writes:
Andrew> need to install the instructions for building and installing the
Andrew> 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>/'.
How about reversing ghe first sentence to emphasize what
packages must do, and not the sys admins (which is the rationale?)
+ Packages must not require the existance of any files in
+ <file>/usr/share/doc/</file> in order to function<footnote
+ id="rationale"><p> The system administrator should be able to
+ delete files in <file>/usr/share/doc/</file> without causing
+ any programs to break.</p></footnote>. Any files
+ that are referenced by programs but are also useful as standalone
+ documentation should be installed under <file>/usr/share/doc/</file>
+ with symbolic links from <file>/usr/share/doc/<package></file>
manoj
--
Remember: Silly is a state of Mind, Stupid is a way of Life. Dave
Butler
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: