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

Bug#212814: please clarify 3.4: description of a package

Package: debian-policy
Severity: wishlist

triggered by #209693, the question is, if the long description should
be understandable on its own, or together with the short description.

    Description: Documentation for an array processing package for Python
     This package contains the manual in PDF format.

Clearly the long description is unreadable by itself. lintian on the
other hand does check, if the short description is repeated in the
long description.

Proposing a change like: "the long description should always be
displayed together with the synopsis, there is no need to repeat the
synopsis in some form in the long description".

Reply to: