Reword the schroot session ID listing commands for people new to schroot

[mirror/dsa-wiki.git] / input / doc / schroot.mdwn

diff --git a/input/doc/schroot.mdwn b/input/doc/schroot.mdwn
index 874ebf5..e690a18 100644 (file)
--- a/input/doc/schroot.mdwn
+++ b/input/doc/schroot.mdwn
@@ -8,15 +8,12 @@ When logging into Debian porterbox machine:
        $ schroot -l
 </code></pre>
 
-* Set a session name:
-<pre><code>
-       $ sessionid=sid-$USER-$RANDOM
-       $ echo "My session name is: $sessionid"
-</code></pre>
-
 * Begin a persistent schroot session on Debian unstable:
 <pre><code>
-       $ schroot -b -c sid -n $sessionid
+       # 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:
@@ -28,9 +25,9 @@ When logging into Debian porterbox machine:
        [..]
 </code></pre>
 
-* Install your broken package build dependencies:
+* Install your build dependencies:
 <pre><code>
-       $ dd-schroot-cmd -c $sessionid apt-get build-dep gentoo
+       $ dd-schroot-cmd -c $sessionid apt-get build-dep hello
        [..]
        Do it for real [Y/n]: <Enter>
        [..]
@@ -41,9 +38,9 @@ When logging into Debian porterbox machine:
        $ schroot -r -c $sessionid
 </code></pre>
 
-* Download your broken package source:
+* Download your source:
 <pre><code>
-       (sid_arch-dchroot)user@porterbox:~$ apt-get source gentoo
+       (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:
@@ -53,11 +50,14 @@ When logging into Debian porterbox machine:
        $ exit
 </code></pre>
 
-* List (your) open sessions:
+* List your currently open sessions:
 <pre><code>
-       $ schroot --list --all-sessions
-or
        $ 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.