From 62c4d2ce822cb55bd3db0c0c386d6ca0bc78a8df Mon Sep 17 00:00:00 2001
From: Austin Seipp <mad.one@gmail.com>
Date: Mon, 23 Jan 2012 15:53:12 -0600
Subject: [PATCH] Add an INSTALL.txt and make it part of the source
 distribution

---
 INSTALL.txt | 68 +++++++++++++++++++++++++++++++++++++++++++++++++++++
 mk/dist.mk  |  1 +
 2 files changed, 69 insertions(+)
 create mode 100644 INSTALL.txt

diff --git a/INSTALL.txt b/INSTALL.txt
new file mode 100644
index 00000000000..da00abd8cb9
--- /dev/null
+++ b/INSTALL.txt
@@ -0,0 +1,68 @@
+### Installing Rust
+
+Windows installer
+=========================
+
+FIXME: the installer is broken and borks %PATH%
+
+
+Source build
+=========================
+
+The Rust compiler is slightly unusual in that it is written in Rust and
+therefore must be built by a precompiled "snapshot" version of itself (made in
+an earlier state of development). As such, source builds require that:
+
+    * You are connected to the internet, to fetch snapshots.
+
+    * You can at least execute snapshot binaries of one of the forms we offer
+      them in. Currently we build and test snapshots on:
+        * Windows (7, server 2008 r2) x86 only
+        * Linux 2.6.x (various distributions) x86 and x86-64
+        * OSX 10.6 ("Snow leopard") or 10.7 ("Lion") x86 and x86-64
+
+You may find other platforms work, but these are our "tier 1" supported build
+environments that are most likely to work. Further platforms will be added to
+the list in the future via cross-compilation.
+
+To build from source you will also need the following prerequisite packages:
+
+    * g++ 4.4 or clang++ 3.x
+    * python 2.6 or later
+    * perl 5.0 or later
+    * gnu make 3.81 or later
+    * curl
+
+
+Building and installing
+=========================
+
+Assuming you're on a relatively modern Linux/OSX system and have met the
+prerequisites, something along these lines should work:
+
+    $ tar -xzf rust-0.1.tar.gz
+    $ cd rust-0.1
+    $ ./configure
+    $ make && make install
+
+When complete, make install will place the following programs into
+/usr/local/bin:
+
+    * rustc, the Rust compiler
+    * rustdoc, the API-documentation tool
+    * cargo, the Rust package manager
+
+In addition to a manual page under /usr/local/share/man and a set of host and
+target libraries under /usr/local/lib/rustc.
+
+The install locations can be adjusted by passing a --prefix argument to
+configure. Various other options are also supported, pass --help for more
+information on them.
+
+
+More help
+=========================
+
+Be sure to check out the 'Getting started' page on the Rust wiki:
+
+    https://github.com/mozilla/rust/wiki/Doc-getting-started
diff --git a/mk/dist.mk b/mk/dist.mk
index 6fea26af022..82ba2a82a68 100644
--- a/mk/dist.mk
+++ b/mk/dist.mk
@@ -15,6 +15,7 @@ PKG_GITMODULES := $(S)src/libuv $(S)src/llvm
 
 PKG_FILES := \
     $(S)LICENSE.txt $(S)README.txt             \
+    $(S)INSTALL.txt                            \
     $(S)configure $(S)Makefile.in              \
     $(S)man                                    \
     $(S)doc                                    \