X-Git-Url: https://git.adam-barratt.org.uk/?a=blobdiff_plain;f=input%2Fdoc%2Fschroot.mdwn;h=307515d1ccd6f91c6d809cc7249affc50195afc9;hb=10b533bc325f7e3fbba499e7c68a0628e1e079f2;hp=ebca695c87ddd3a1c96fd7f1324c6eb58074fa50;hpb=1c78b02f51196bb02b0115407537d6664fd5fcb4;p=mirror%2Fdsa-wiki.git

diff --git a/input/doc/schroot.mdwn b/input/doc/schroot.mdwn
index ebca695..307515d 100644
--- a/input/doc/schroot.mdwn
+++ b/input/doc/schroot.mdwn
@@ -1,38 +1,28 @@
 using schroot in debian.org porterboxes
 =======================================
 
-When logging into Debian porterbox machine, it should display similar message:
-<pre><code>
-Welcome to porterbox.debian.org, the Debian arch porterbox.
-
-See 'schroot -l' for a list of available chroots.  Start new sessions
-with 'schroot --begin-session -c <chroot>', run commands in sessions using
-'schroot --run-session -c <session> [-- command]', and tear down sessions
-using 'schroot --end-session -c <session>'.  You can run a limited set of
-privileged commands, for instance some of apt-get, using
-'dd-schroot-cmd -c <session> <command>'.
-Use 'schroot --list --all-sessions' or 'schroot-list-sessions [<userglob>]'
-to list (your) open sessions.
-
-This server is hosted at data centre.
-</code></pre>
-
-The previous description is rather compact and dense, so let's try to describe the usage in more friendly way.
+When logging into Debian porterbox machine:
 
 * List available chroots:
 <pre><code>
 	$ schroot -l
 </code></pre>
 
+* Set a session name:
+<pre><code>
+	$ mysid=sid$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
+	$ 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
+	$ dd-schroot-cmd -c $mysid apt-get update
+	$ dd-schroot-cmd -c $mysid apt-get upgrade
 	[..]
 	Do it for real [Y/n]: <Enter>
 	[..]
@@ -40,7 +30,7 @@ The previous description is rather compact and dense, so let's try to describe t
 
 * Install your broken package build dependencies:
 <pre><code>
-	$ dd-schroot-cmd -c mysid apt-get build-dep gentoo
+	$ dd-schroot-cmd -c $mysid apt-get build-dep gentoo
 	[..]
 	Do it for real [Y/n]: <Enter>
 	[..]
@@ -48,7 +38,7 @@ The previous description is rather compact and dense, so let's try to describe t
 
 * Change root to Debian unstable chroot:
 <pre><code>
-	$ schroot -r -c mysid
+	$ schroot -r -c $mysid
 </code></pre>
 
 * Download your broken package source:
@@ -59,8 +49,15 @@ The previous description is rather compact and dense, so let's try to describe t
 * 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
+	$ 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.