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

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/&lt;package&gt;</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: