From 62c4d2ce822cb55bd3db0c0c386d6ca0bc78a8df Mon Sep 17 00:00:00 2001 From: Austin Seipp 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 \