* pbuilder-satisfydepends-experimental, Makefile: alternate

implementation of pbuilder-satisfydepends which supports pulling
build-deps with a version on the apt-get command-line; this is derived
from pbuilder-satisfydepends with the following changes:
- Add and use new package_versions() and candidate_version() helpers;
  the former returns all versions of a package available via APT, the
  later APT's candidate version.
- For versionned build-deps, when building the "apt-get install"
  command, try APT's candidate version or all available versions
  available from APT in ascending order (the reverse order of
  apt-cache's output); checkbuilddep_versiondeps() isn't used for this
  part of the process anymore, but it is still used to honor
  build-conflicts.
- Recover from APT errors caused by unsufficient dependencies
  ("libfoo-dev Depends: bar but baz is to be installed") and missing
  dependencies libfoo-dev Depends: bar but it is not going to be
  installed", or simply "libfoo-dev Depends: bar"); this permits
  simply listing build-deps when uploading to experimental; achieved
  by moving the version matching logic in the new
  versioneddep_to_aptcmd() helper.
* pbuilderrc, pbuilderrc.5: document the availability of the alternate
implementation.

1 files changed, 4 insertions, 1 deletions

diff --git a/pbuilderrc.5 b/pbuilderrc.5
index 4780ff4..f65f768 100644
--- a/pbuilderrc.5
+++ b/pbuilderrc.5
@@ -216,7 +216,10 @@ in
 .BI "PBUILDERSATISFYDEPENDSCMD=" "/usr/lib/pbuilder/pbuilder-satisfydepends"
 
 This option is used by various parts of pbuilder to satisfy (i.e. install) the
-build-dependencies of a package.
+build-dependencies of a package.  There is an alternate experimental
+implementation, "pbuilder-satisfydepends-experimental", which might be useful
+to pull packages from experimental or from repositories with a low APT Pin
+Priority.
 
 .TP
 .BI "BUILDUSERID=" "1234"