X-Git-Url: https://git.adam-barratt.org.uk/?p=mirror%2Fdsa-wiki.git;a=blobdiff_plain;f=input%2Fdoc%2Fschroot.mdwn;h=e690a1841c64e44ce5411a7f876a262f98c88a45;hp=6266cc428b7968224f10ebda5c7e4a7a0c588105;hb=eba3cc46986eda2324decd06afed3f78e9ec7864;hpb=7e639b510c06b270d0f9ac2f849f0b3843ccd626

diff --git a/input/doc/schroot.mdwn b/input/doc/schroot.mdwn
index 6266cc4..e690a18 100644
--- a/input/doc/schroot.mdwn
+++ b/input/doc/schroot.mdwn
@@ -1,16 +1,63 @@
 using schroot in debian.org porterboxes
 =======================================
 
-Welcome to porterbox.debian.org, the Debian arch porterbox.
+When logging into Debian porterbox machine:
 
-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.
+* List available chroots:
+<pre><code>
+	$ schroot -l
+</code></pre>
 
-This server is hosted at data centre.
+* Begin a persistent schroot session on Debian unstable:
+<pre><code>
+	# Pick your own session name:
+	$ echo -n "Session ID: " && read sessionid && schroot -b -c sid -n $sessionid
+	# or use a random one:
+	$ sessionid=$(schroot -b -c sid)
+</code></pre>
 
+* Update and upgrade Debian unstable chroot:
+<pre><code>
+	$ dd-schroot-cmd -c $sessionid apt-get update
+	$ dd-schroot-cmd -c $sessionid apt-get upgrade
+	[..]
+	Do it for real [Y/n]: <Enter>
+	[..]
+</code></pre>
+
+* Install your build dependencies:
+<pre><code>
+	$ dd-schroot-cmd -c $sessionid apt-get build-dep hello
+	[..]
+	Do it for real [Y/n]: <Enter>
+	[..]
+</code></pre>
+
+* Change root to Debian unstable chroot:
+<pre><code>
+	$ schroot -r -c $sessionid
+</code></pre>
+
+* Download your source:
+<pre><code>
+	(sid_arch-dchroot)user@porterbox:~$ apt-get source hello
+</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 $sessionid
+	$ exit
+</code></pre>
+
+* List your currently open sessions:
+<pre><code>
+	$ schroot-list-sessions
+</code></pre>
+
+* List all currently open sessions:
+<pre><code>
+	$ schroot --list --all-sessions
+</code></pre>
+
+* You should be done by now. If you find any issue, please report to debian-admin@lists.debian.org.