using schroot in debian.org porterboxes
=======================================

When logging into Debian porterbox machine:

* List available chroots:
<pre><code>
	$ schroot -l
</code></pre>

* Set a session name:
<pre><code>
	$ mysid=sid-$USER-$RANDOM
	$ echo "My session name is: $mysid"
</code></pre>

* Begin a persistent schroot session on Debian unstable:
<pre><code>
	$ schroot -b -c sid -n $mysid
</code></pre>

* Update and upgrade Debian unstable chroot:
<pre><code>
	$ dd-schroot-cmd -c $mysid apt-get update
	$ dd-schroot-cmd -c $mysid apt-get upgrade
	[..]
	Do it for real [Y/n]: <Enter>
	[..]
</code></pre>

* Install your broken package build dependencies:
<pre><code>
	$ dd-schroot-cmd -c $mysid apt-get build-dep gentoo
	[..]
	Do it for real [Y/n]: <Enter>
	[..]
</code></pre>

* Change root to Debian unstable chroot:
<pre><code>
	$ schroot -r -c $mysid
</code></pre>

* Download your broken package source:
<pre><code>
	(sid_arch-dchroot)user@porterbox:~$ apt-get source gentoo
</code></pre>

* You should be able to reproduce your issue, hack on the package, fix the bug. Once you are done with your work, please, finish your schroot session:
<pre><code>
	(sid_arch-dchroot)user@porterbox:~$ exit
	$ schroot -e -c $mysid
	$ exit
</code></pre>

* List (your) open sessions:
<pre><code>
	$ schroot --list --all-sessions
or
	$ schroot-list-sessions
</code></pre>

* You should be done by now. If you find any issue, please report to debian-admin@lists.debian.org.