From bcf0607bd3940596cb696c2bb10e5542dd15d3dd Mon Sep 17 00:00:00 2001 From: =?utf8?q?H=C3=A9ctor=20Or=C3=B3n=20Mart=C3=ADnez?= Date: Sun, 16 Jun 2013 14:13:08 +0200 Subject: [PATCH] Improve schroot documentation MIME-Version: 1.0 Content-Type: text/plain; charset=utf8 Content-Transfer-Encoding: 8bit Signed-off-by: Héctor Orón Martínez --- input/doc/schroot.mdwn | 44 ++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 44 insertions(+) diff --git a/input/doc/schroot.mdwn b/input/doc/schroot.mdwn index 6266cc4..4fecdde 100644 --- a/input/doc/schroot.mdwn +++ b/input/doc/schroot.mdwn @@ -1,6 +1,9 @@ using schroot in debian.org porterboxes ======================================= +When logging into Debian porterbox machine, it should display similar message: + +

 Welcome to porterbox.debian.org, the Debian arch porterbox.
 
 See 'schroot -l' for a list of available chroots.  Start new sessions
@@ -13,4 +16,45 @@ Use 'schroot --list --all-sessions' or 'schroot-list-sessions []'
 to list (your) open sessions.
 
 This server is hosted at data centre.
+
+ +The previous description is rather compact and dense, so let's try to describe the usage in more friendly way. + +* List available chroots: + + $ schroot -l + +* Begin a persistent schroot session on Debian unstable: + + $ schroot -b -c sid -n mysid + +* Update and upgrade Debian unstable chroot: + + $ dd-schroot-cmd -c mysid apt-get update + $ dd-schroot-cmd -c mysid apt-get upgrade + [..] + Do it for real [Y/n]: + [..] + +* Install your broken package build dependencies: + + $ dd-schroot-cmd -c mysid apt-get build-dep gentoo + [..] + Do it for real [Y/n]: + [..] + +* Change root to Debian unstable chroot: + + $ schroot -r -c mysid + +* Download your broken package source: + + (sid_arch-dchroot)user@porterbox:~$ apt-get source gentoo + +* 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: + + (sid_arch-dchroot)user@porterbox:~$ exit + $ schroot -e -c mysid + $ exit +* You should be done by now. If you find any issue, please report to debian-admin@lists.debian.org. -- 2.20.1