Improved Documentation

-
-
-
 To get the newest version version: 
 1) apt-get install git
 2) git clone https://git.gitorious.org/debian-bootstrap/gsoc2013.git
@@ -8,13 +5,19 @@ To get the newest version version:
 If you want to test the toolchain, just run: 
 ./run-cross.sh {your package sign key}
 
+
 If this is your first time running sbuild, the script might return error
 and you should restart your session, so your user are going to be in the
 sbuild group. After that, just re-execute the command and it will run 
-without problems. Note that the userdir module from apache should be loaded.
+without problems. 
+
+Note that the userdir module from apache should be loaded.
 This is required to have a local repository in the users public_html 
 accessible through http://127.0.0.1/~$USER/
 
+Note that the secret key of the key you are using to sign the packages must
+be available in the user home that is running the scripts.
+
 The files run-native.sh and run-cross.sh are examples of the execution of both
 scripts. By running ./run-cross.sh the script should be able to setup an
 crossbuild environment and run the automated bootstrap scripts. The steps 
@@ -45,12 +48,16 @@ autobootstrap/	--> Scripts and other files related with the development
 	create-chroot.sh	--> Script that creates a chroot environment
 				ready to be used by the automated bootstrap
 				script.
-	order1.lst		--> 
-	order2.lst		--> 
-	autobootstrap.pl	--> 
-	bug.workaround		--> 
-	make-patch.pl		--> 
-	order1.lst.orig		--> 
+	order1.lst		--> This is a native build order obtained
+				runnong botch. This is a cycle free build order
+	order2.lst		--> This is a native build order obtained
+				running botch. This build order has cycles
+	autobootstrap.pl	--> This is the script that automatically 
+				builds/crossbuilds packages
+	bug.workaround		--> This file is a way found to workaround the
+				bug 722880. 
+	make-patch.pl		--> Script that automatically create patch
+				for a source package. 
 
 autobootstrap/repositories/	--> Keep the default repository configurations
 	prepare_repos.sh	--> script to prepare all repositories to be

 #!/usr/bin/perl
 #
 # Author: Gustavo Alkmim (alkmim@ic.unicamp.br)
-# Chagelog: 
-#     Aug 09, 2013 -  First Version
 #
-# TODO: 
+
 use strict;
 use diagnostics;
 use Dpkg::Control::Info;

 #!/usr/bin/perl
 #
 # Author: Gustavo Alkmim (alkmim@ic.unicamp.br)
-# Chagelog: 
-#     Aug 27, 2013 -  First Version
-#
-# TODO: 
 #
 
 use strict;

 #!/bin/sh -e
+#
+# Author: Gustavo Alkmim (alkmim@ic.unicamp.br)
+#
 
 echo " + running grep-dctrl..." >&2
 

 #! /bin/bash
+#
+# Author: Gustavo Alkmim (alkmim@ic.unicamp.br)
+#
 
 upstream_repo=$1
 upstream_suite=$2
@@ -46,7 +49,7 @@ echo "deb [arch=$buildarch,$hostarch] $toolchain_repo $toolchain_suite main " >>
 
 echo "mk-sbuild --debug --arch=$arch --name=$chroot_name\-$hostarch --source-template=\"$PWD/sources.list\" --debootstrap-include=\"devscripts,build-essential,locales,debhelper --keyring=$keyring_file\" --debootstrap-mirror=$upstream_repo $upstream_suite"
 #mk-sbuild --debug --arch=$buildarch --name=$chroot_name\-$hostarch --source-template="$PWD/sources.list" --debootstrap-include="devscripts,build-essential,locales,debhelper --keyring=$keyring_file" --debootstrap-mirror=$upstream_repo $upstream_suite
-#mk-sbuild --arch=$buildarch --name=$chroot_name\-$hostarch --source-template="$PWD/sources.list" --debootstrap-include="devscripts,build-essential,locales,debhelper --no-check-gpg" --debootstrap-mirror=$upstream_repo $upstream_suite
+mk-sbuild --arch=$buildarch --name=$chroot_name\-$hostarch --source-template="$PWD/sources.list" --debootstrap-include="devscripts,build-essential,locales,debhelper --no-check-gpg" --debootstrap-mirror=$upstream_repo $upstream_suite
 
 #sudo schroot -c source:$chroot_name\-$arch -u root dpkg-reconfigure 					locales
 

 #!/usr/bin/perl
 #
 # Author: Gustavo Alkmim (alkmim@ic.unicamp.br)
-# Chagelog: 
-#     Aug 09, 2013 -  First Version
 #
-# TODO: 
 use strict;
 use diagnostics;
 use Dpkg::Control::Info;