[buildd-tools-devel] Bug#588755: sbuild: Please document --build-dep-resolver

[Cyril Brulebois]

Package: sbuild
Version: 0.60.0-1
Severity: wishlist
Tags: patch

Hi,

as discussed on IRC, here's a patch for sbuild(1), documenting
--build-dep-resolver. That should be helping getting #559655 closer to
being closed.

Mraw,
KiBi.
-------------- next part --------------
>From be33fa3e5fe743122b5dd62471c8e74df02f2b8a Mon Sep 17 00:00:00 2001
From: Cyril Brulebois <kibi at debian.org>
Date: Sun, 11 Jul 2010 23:28:02 +0200
Subject: [PATCH] man: Document --build-dep-resolver for sbuild.

---
 man/sbuild.1.in |    7 +++++++
 1 files changed, 7 insertions(+), 0 deletions(-)

diff --git a/man/sbuild.1.in b/man/sbuild.1.in
index 699183c..18ea8db 100644
--- a/man/sbuild.1.in
+++ b/man/sbuild.1.in
@@ -46,6 +46,7 @@ sbuild \- build debian packages from source
 .RB [ \-b \[or] \-\-batch]
 .RB [ \-n \[or] \-\-nolog ]
 .RB [ \-\-setup\-hook=\fIhook-script\fP ]
+.RB [ \-\-build\-dep\-resolver=\fIresolver\fP ]
 .BR PACKAGE1_VERSION[.dsc] " [" PACKAGE2_VERSION[.dsc] " [" PACKAGE\f[BI]n\fP_VERSION[.dsc] ]]
 .SH VERSION
 This man page documents the packaged version of sbuild.  This version
@@ -240,6 +241,12 @@ Run the specified script inside the chroot before building.  This script may
 perform any required actions to customise or configure the chroot.  Note that
 the script will be run inside the chroot, and so the script must exist inside
 the chroot rather than the host system.
+.TP
+.BR "\-\-build\-dep\-resolver=\fIresolver\fP"
+Use the specified resolver to handle selecting the build dependencies.
+Supported resolvers are \fIinternal\fP (the default) and \fIaptitude\fP.  The
+latter tries to be smarter but is also slower.  It may be of some help when
+trying to pull build dependencies from an extra suite, like \fIexperimental\fP.
 .SH ENVIRONMENT VARIABLES
 The following environment variables are used by \fBsbuild\fR:
 .IP "DEBEMAIL"
-- 
1.7.1