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

[SCM] Debian package checker branch, master, updated. 2.2.15-14-g93d817d



The following commit has been merged in the master branch:
commit 134e89180813bf5d907b63c7fdbb668ec9ced903
Author: Russ Allbery <rra@debian.org>
Date:   Mon Sep 14 22:29:34 2009 -0700

    Wording tweaks for lib-recommends-documentation

diff --git a/checks/fields.desc b/checks/fields.desc
index 268179a..8ab6024 100644
--- a/checks/fields.desc
+++ b/checks/fields.desc
@@ -939,8 +939,12 @@ Info: The VCS-* field uses an URI which doesn't match any known format.
 Tag: lib-recommends-documentation
 Severity: normal
 Certainty: possible
-Info: The given package appears to be a library but it recommends a
- documentation package.  Doing so is not recommended as libraries
- usually make part of the dependencies of other packages, and this may
- lead to users installing unwanted documentation packages (given that
- recommends are installed by default).
+Info: The given package appears to be a library package, but it recommends
+ a documentation package.  Doing this can pull in unwanted (and often
+ large) documentation packages since recommends are installed by default
+ and library packages are pulled by applications that use them.  Users
+ usually only care about the library documentation if they're developing
+ against the library, not just using it, so the development package should
+ recommend the documentation instead.  If there is no development package
+ (for modules for scripting languages, for example), consider Suggests
+ instead of Recommends.

-- 
Debian package checker


Reply to: