Control: tags -1 + patch
Hi,
On Wed, 22 Apr 2015 12:13:37 -0700 Dima Kogan wrote:
> Hi. In the sbuild manpage, the only thing stated about --dist is
>
>-d, --dist=distribution
> Fetch source packages from specified distribution.
>
> This description implies that this setting only controls where sources
> come from, which isn't the case. In particular, --dist sets the
> OVERRIDE_DISTRIBUTION setting (set_options() in Options.pm), and this
> setting affects what ends up in the .changes file (build() in Build.pm).
> I think the manpage description should say this.
indeed! Thanks for bringing this up. The --dist option has so many side effects
that there definitely needs more explaining to be done.
I have attached patch in my local git and will soon push it to the remote if
there are no further remarks.
Thanks!
cheers, josch
From 8b9c2e45edc6ed08ea9a748a7dcc6b0ef6e1899c Mon Sep 17 00:00:00 2001
From: Johannes 'josch' Schauer
Date: Thu, 1 Oct 2015 07:37:59 +0200
Subject: [PATCH] man/sbuild.1.in: update docs for --dist option (Closes:
#783135)
---
man/sbuild.1.in | 6 +-
1 file changed, 5 insertions(+), 1 deletion(-)
diff --git a/man/sbuild.1.in b/man/sbuild.1.in
index 6696636..6454dfb 100644
--- a/man/sbuild.1.in
+++ b/man/sbuild.1.in
@@ -202,7 +202,11 @@ Use the specified chroot. If not specified, the default is the first of
\fI$distribution\-$arch\fP or \fI$distribution\fP that exists.
.TP
.BR \-d ", " "\-\-dist=\fIdistribution\fP"
-Fetch source packages from specified distribution.
+Explicitly set the distribution for the package build. This will be selecting
+the correct chroot to use and also sets the value of the Distribution field in
+the created .changes file. Setting this option is necessary when giving sbuild
+a .dsc file or a plain source package name to build. In the latter case it
+specifies the distribution the source package is fetched from.
.TP
.BR \-\-archive=\fIarchive\fP
Communicate with specified archive.
--
2.5.1
signature.asc
Description: signature