Bug#160248: section 13.3 unnecessarily obscure
[aaargh. This one should have gone to the bug]
>>"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
--
The world's most avid baseball fan (an Aggie) had arrived at the
stadium for the first game of the World Series only to realize he had
left his ticket at home. Not wanting to miss any of the first
inning, he went to the ticket booth and got in a long line for
another seat. After an hour's wait he was just a few feet from the
booth when a voice called out, "Hey, Dave!" The Aggie looked up,
stepped out of line and tried to find the owner of the voice -- with
no success. Then he realized he had lost his place in line and had
to wait all over again. When the fan finally bought his ticket, he
was thirsty, so he went to buy a drink. The line at the concession
stand was long, too, but since the game hadn't started he decided to
wait. Just as he got to the window, a voice called out, "Hey, Dave!"
Again the Aggie tried to find the voice -- but no luck. He was very
upset as he got back in line for his drink. Finally the fan went to
his seat, eager for the game to begin. As he waited for the pitch, he
heard the voice calling, "Hey Dave!" once more. Furious, he stood up
and yelled at the top of his lungs, "My name isn't Dave!"
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: