+Introduction
+------------
+
These scripts are intended to ease the process of bootstrapping a Debian
chroot on an Android device. Instructions for installing such a chroot
may be found at:
http://www.steven-mcdonald.id.au/tutorials/debian_on_samsung_galaxy.shtml
+
+
+Overview
+--------
+
+These scripts come in pairs; the ones under android/ are to be executed
+in an Android environment, and the ones under debian/ get executed in a
+chroot by the Android scripts.
+
+These scripts are ready to roll if:
+
+- your Debian chroot lives in /debian,
+- you place the scripts under android/ in /data/local/bin/, and
+- you place the scripts under debian/ in /debian/usr/local/sbin/.
+
+If this is not the case, then you will need to modify these scripts to
+work for you. Note that you will probably need to modify
+debian/debian-init anyway, to specify which services you want to have
+started automatically.
+
+
+Starting Debian services at boot time
+-------------------------------------
+
+In order to run the debian-init script at boot time, you can add the
+following to /system/etc/init.local.rc:
+
+service debian /data/local/bin/debian-init
+ user root
+ group root
+
+For some reason, Android's init won't start Debian if supplied with the
+'oneshot' option, so do not use that.
+
+
+Mounting Android file systems within the chroot
+-----------------------------------------------
+
+If you'd like to be able to manipulate Android's file systems from
+Debian, you can bind-mount them under /debian/android/. The debian-init
+script will do this for you, based on searching through the file system
+tree under /debian/android/ looking for empty directories. Just create a
+directory /debian/android/foo for each /foo in Android you want to be
+mounted in this way, and debian-init will mount it appropriately at boot
+time.
+
+
+Using a Debian shell from an Android terminal emulator
+------------------------------------------------------
+
+If you want your device's terminal emulator to default to using a shell
+in a Debian environment, just use /data/local/bin/debian-sh as your
+shell. This will su to root if you aren't already, chroot into Debian,
+set some environment variables and then execute bash in a Debian
+environment.