From 0a902dbdeb050286e0b8addce3967462c2e38f8b Mon Sep 17 00:00:00 2001
From: Junichi Uekawa <dancer@dancer64.netfort.gr.jp>
Date: Fri, 27 Jul 2007 07:32:43 +0900
Subject: * Bug fix: "$HOME/.pbuilderrc example for use in using multiple
 pbuilder   setups", thanks to Andres Mejia (Closes: #432277).

---
 ChangeLog                      |  5 +++++
 Documentation/pbuilder-doc.xml | 51 ++++++++++++++++++++++++++++++++++++++++++
 debian/changelog               |  4 +++-
 3 files changed, 59 insertions(+), 1 deletion(-)

diff --git a/ChangeLog b/ChangeLog
index f682b82..af8d664 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,8 @@
+2007-07-27  Junichi Uekawa  <dancer@debian.org>
+
+	* Documentation/pbuilder-doc.xml: add document on example usage of
+	pbuilderrc with DIST env-var.
+
 2007-07-22  Junichi Uekawa  <dancer@debian.org>
 
 	* Documentation/pbuilder-doc.xml: refer to example file.
diff --git a/Documentation/pbuilder-doc.xml b/Documentation/pbuilder-doc.xml
index 9d5af6e..de98ae9 100644
--- a/Documentation/pbuilder-doc.xml
+++ b/Documentation/pbuilder-doc.xml
@@ -864,6 +864,57 @@ $ sudo pbuilder update --hookdir ~/loginhooks/E10shell
 	<command>pbuilder</command> with a etch chroot.
       </para>
     </sect1>
+    <sect1 id="ENVVARDISTRIBUTIONSWITCH">
+      <title>Using environmental variables for running <command>pbuilder</command>
+	for specific distribution
+      </title>
+      <para>      This section<footnote>
+	  <para>This part of the documentation contributed by Andres Mejia</para>
+	  <para>
+	    This example was taken from a wiki (<ulink url="https://wiki.ubuntu.com/PbuilderHowto">https://wiki.ubuntu.com/PbuilderHowto</ulink>).
+      </para>
+
+	</footnote>
+	describes briefly a way to setup and use multiple pbuilder setups
+	by creating a pbuilderrc configuration in your home path (<filename>$HOME/.pbuilderrc</filename>)
+	and using the variable "DIST" when running pbuilder or pdebuild.
+</para>
+      <para>      First, setup <filename>$HOME/.pbuilderrc</filename> to look like:</para>
+      <para>
+	<screen>
+if [ -n "${DIST}" ]; then
+        BASETGZ="`dirname $BASETGZ`/$DIST-base.tgz"
+        DISTRIBUTION="$DIST"
+        BUILDRESULT="/var/cache/pbuilder/$DIST/result/"
+        APTCACHE="/var/cache/pbuilder/$DIST/aptcache/"
+fi
+</screen></para>
+      <para>Then, whenever you wish to use pbuilder for a particular distro, assign a value
+to "DIST" that is one of the distros available for Debian or any Debian based
+distro you happen to be running (i.e. whatever is found under
+/usr/lib/debootstrap/scripts).
+      </para>
+
+      <para>Here's some examples on running pbuilder or pdebuild:
+</para>
+      <para><screen>
+DIST=gutsy sudo pbuilder create
+
+DIST=sid sudo pbuilder create --mirror http://http.us.debian.org/debian
+
+DIST=gutsy sudo pbuilder create \
+        --othermirror "deb http://archive.ubuntu.com/ubuntu gutsy universe \
+        multiverse"
+
+DIST=gutsy sudo pbuilder update
+
+DIST=sid sudo pbuilder update --override-config --mirror \
+http://http.us.debian.org/debian \
+--othermirror "deb http://http.us.debian.org/debian sid contrib non-free"
+
+DIST=gutsy pdebuild
+</screen></para>
+    </sect1>
     <sect1 id="usingspecialaptsources">
       <title>Using special apt sources lists, and local packages</title>
       <para>
diff --git a/debian/changelog b/debian/changelog
index 90bbf4e..e88514b 100644
--- a/debian/changelog
+++ b/debian/changelog
@@ -1,8 +1,10 @@
 pbuilder (0.171) UNRELEASED; urgency=low
 
   * add example configuration file for ccache.
+  * Bug fix: "$HOME/.pbuilderrc example for use in using multiple pbuilder
+    setups", thanks to Andres Mejia (Closes: #432277).
 
- -- Junichi Uekawa <dancer@debian.org>  Sun, 22 Jul 2007 13:15:57 +0900
+ -- Junichi Uekawa <dancer@debian.org>  Fri, 27 Jul 2007 07:31:45 +0900
 
 pbuilder (0.170) unstable; urgency=low
 
-- 
cgit v1.2.3