+the [Termux](https://termux.com/) Android application.
+
+The scripts and patches to build each package is licensed under the same license as
+the actual package (so the patches and scripts to build bash are licensed under
+the same license as bash, while the patches and scripts to build python are licensed
+under the same license as python, etc).
+
+NOTE: This is in a rough state - be prepared for some work and frustrations, and give
+feedback if you find incorrect our outdated things!
+
+
+Build environment on Ubuntu 16.04
+=================================
+Packages are normally built using Ubuntu 16.04. Most packages should build also under
+other Linux distributions (or even on OS X), but those environments will need manual setup
+adapted from the below setup for Ubuntu:
+
+* Run `scripts/setup-ubuntu.sh` to install required packages and setup the `/data/` folder.
+
+* Run `scripts/setup-android-sdk.sh` to install the Android SDK and NDK at `$HOME/lib/android-{sdk,ndk}`.
+
+
+Build environment using Docker
+==============================
+A Docker container configured for building images can be downloaded and run with:
+
+ ./scripts/run-docker.sh
+
+This will set you up with a interactive prompt in a container, where this source folder
+is mounted as the /root/termux-packages data volume, so changes are kept in sync between
+the host and the container when trying things out before committing, and built deb files
+will be available on the host in the `debs/` directory just as when building on the host.
+
+Build commands can be given to be executed in the docker container directly:
+
+ ./scripts/run-docker.sh ./build-package.sh libandroid-support
+
+will launch the docker container, execute the `./build-package.sh libandroid-support`
+command inside it and afterwards return you to the host prompt, with the newly built
+deb in `debs/` to try out.