From 754cf3805f2f2bfaa83f5ebe73024211dc27624a Mon Sep 17 00:00:00 2001
From: David Nadlinger <code@klickverbot.at>
Date: Tue, 18 Sep 2012 23:40:24 +0200
Subject: [PATCH] Added first draft of useful README.

Needs to be expanded with a short section on contributing (and a
separate CONTRIBUTING file, for the GitHub feature), ...

LICENSE also needs an overhaul, and our files need license headers.
---
 README     | 58 ++++++++++++++++++++++++++++++++++++++++++++++++++++++
 readme.txt |  8 --------
 2 files changed, 58 insertions(+), 8 deletions(-)
 create mode 100644 README
 delete mode 100644 readme.txt

diff --git a/README b/README
new file mode 100644
index 00000000..b65fd7cb
--- /dev/null
+++ b/README
@@ -0,0 +1,58 @@
+LDC – the LLVM D Compiler
+=========================
+
+The LDC project aims to provide a portable D programming language
+compiler with modern optimization and code generation capabilities.
+
+The compiler uses the official DMD frontends to support both D1 and D2,
+and relies on the LLVM Core libraries for code generation.
+
+LDC is fully Open Source; the parts of the code not taken/adapted from
+other projects are BSD-licensed (see the LICENSE file for details).
+
+Please consult the project website for further information:
+http://ldc-developers.github.com
+
+
+Installation
+------------
+
+In-depth material on building and installing LDC and the standard
+libraries, including experimental instructions for running LDC on
+Windows, is available on the project wiki, at
+https://github.com/ldc-developers/ldc/wiki/Installation.
+
+For the impatient, a quick guide for building on *nix systems:
+
+ 1) Make sure your system has the necessary prerequisites:
+  - a working C++ build environment,
+  - CMake,
+  - LLVM 3.0+ (3.1 preferred),
+  - libconfig++ (http://hyperrealm.com/libconfig/libconfig.html).
+
+ 2) Check out the library submodules, if you have not already:
+  $ cd ldc
+  $ git submodule update --init
+
+ 3) Build and install LDC:
+  $ mkdir build && cd build  # Out-of-source builds are recommended.
+  $ cmake ..  # Use -DD_VERSION=1 to build the D1 compiler.
+  $ make
+  $ make install # Or run LDC directly from the bin/ directory.
+
+In case the above steps do not work, please first visit the extended
+documentation under the aforementioned URL.
+
+Some Linux distributions are also packaging a recent version of LDC,
+so building it manually might not be necessary.
+
+
+Contact
+-------
+
+The best way to get in touch with the developers is either via the
+mailing list at ldc-dev@googlegroups.com, or the #ldc IRC channel on
+FreeNode. We can usually be found on the main (Digital Mars) language
+newsgroups (http://forum.dlang.org) as well.
+
+Feedback of any kind is very much appreciated!
diff --git a/readme.txt b/readme.txt
deleted file mode 100644
index f416b59c..00000000
--- a/readme.txt
+++ /dev/null
@@ -1,8 +0,0 @@
-LLVM D Compiler (LDC)
-
-This compiler is based on the Digital Mars D (DMD) compiler frontend, and
-the LLVM compiler toolkit. See LICENSE for licensing information.
-
-For more information, including build instructions, visit the LDC website:
-
-http://www.dsource.org/projects/ldc