« Return to Thread: Bug#489135: debian-policy: how to document a repackaged .orig.tar.gz

Bug#489135: developers-reference: uses debian-policy style wording

by Bart Martens-3 :: Rate this Message:

Reply to Author | View in Thread

reassign 489135 developers-reference
severity 489135 normal
retitle 489135 developers-reference: uses debian-policy style wording
stop


In my opinion developers-reference should not use must/should/may
wording, because this makes readers confuse developers-reference with
debian-policy.

For example, in developers-reference 3.4.0 :
file:///usr/share/doc/developers-reference/best-pkging-practices.html#bpp-origtargz

        "must contain detailed information how the repackaged source was
        obtained, and how this can be reproduced in the
        debian/copyright."

The word "must" gives the impression that it's a standard to which
Debian software must comply.

Please consider rephrasing the must/should/may parts in
developers-reference to convert these parts to just best-practice
recommendations.  Or, please consider moving those parts to
debian-policy.






--
To UNSUBSCRIBE, email to debian-bugs-dist-REQUEST@...
with a subject of "unsubscribe". Trouble? Contact listmaster@...

 « Return to Thread: Bug#489135: debian-policy: how to document a repackaged .orig.tar.gz

LightInTheBox - Buy quality products at wholesale price!