2 files changed, 51 insertions, 56 deletions

diff --git a/INSTALL b/INSTALL
index ee8983e..005a1aa 100644
--- a/INSTALL
+++ b/INSTALL
@@ -1,7 +1,16 @@
--- INSTALL for Fluxbox
+= INSTALL for Fluxbox
+
+== TL;DR Instructions
+
+    $ ./configure
+    $ make
+
+and then as root
+
+    $ make install
+
+== Compilation and Installation
 
-Compilation and Installation:
---------------------------------
    The `configure' shell script attempts to guess correct values for
 various system-dependent variables used during compilation.  It uses
 those values to create a `Makefile' in each directory in the
@@ -46,8 +55,8 @@ The simplest way to compile this package is:
      a different kind of computer), type `make distclean'. 
 
 
-Compilers and Options:
-----------------------
+== Compilers and Options
+
    Some systems require unusual options for compilation or linking that
 the `configure' script does not know about.  You can give `configure'
 initial values for variables by setting them in the environment.  Using
@@ -58,9 +67,35 @@ this:
 Or on systems that have the `env' program, you can do it like this:
      env CPPFLAGS=-I/usr/local/include LDFLAGS=-s ./configure
 
+=== Cross-Compiler for Microsoft Windows:
+
+You'll want mingw-cross-env installed, with libX11 and mingw-catgets built.
+A configure line that works is:
+
+    $ ./configure \
+        --prefix=/ \
+        --host=i686-pc-mingw32 \
+        --disable-imlib2 \
+        --disable-xmb \
+        --disable-slit \
+        --disable-remember \
+        --disable-toolbar \
+        --disable-fribidi \
+        --disable-nls \
+        --disable-xft \
+        LIBS="-lxcb -lXdmcp -lXau -lpthread -lws2_32"
+
+Then, build and install with
+
+    $ make install DESTDIR=$(pwd)/stage
+
+You can then copy the whole "stage" directory to a Windows machine and
+run it on your choice of X server.
+
+
+
+== Optional Features
 
-Optional Features:
-------------------
 Fluxbox supports the XShape extension of X11R6.  This support is enabled by
 default, but may be overridden by specifying `--disable-shape' on the configure
 script's command line.
@@ -84,7 +119,3 @@ automatically, but if it doesn't, you can use the `configure'
 options `--x-includes=DIR' and `--x-libraries=DIR' to specify
 their locations.
 
-
-Please read the README file also.
-
-
diff --git a/README b/README
index d047baa..4246f40 100644
--- a/README
+++ b/README
@@ -1,44 +1,12 @@
-Fluxbox is a fork of the original Blackbox 0.61.1 sourcecode with
-different goals.
+Fluxbox is a windowmanager for X that was based on the Blackbox 0.61.1 code.
+It is very light on resources and easy to handle but yet full of features to
+make an easy, and extremely fast, desktop experience.
 
-Read NEWS to see whats new in this release.
+Read INSTALL to read about building and installing fluxbox. Read NEWS to see
+whats new in this release, for copyright information see COPYING. For more
+information go to:
 
-For copyright information see COPYING
-
-For more information go to:
-  http://fluxbox.org/
-
-
-Compile and Install:
-
-  $ ./configure
-  $ make
-  and then as root
-  # make install
-
-
-Cross-Compile for Windows:
-
-  You'll want mingw-cross-env installed, with libX11 and mingw-catgets built.
-  A configure line that works is:
-  $ ./configure \
-        --prefix=/ \
-        --host=i686-pc-mingw32 \
-        --disable-imlib2 \
-        --disable-xmb \
-        --disable-slit \
-        --disable-remember \
-        --disable-toolbar \
-        --disable-fribidi \
-        --disable-nls \
-        --disable-xft \
-        LIBS="-lxcb -lXdmcp -lXau -lpthread -lws2_32"
-
-  Then, build and install with
-  $ make install DESTDIR=$(pwd)/stage
-
-  You can then copy the whole "stage" directory to a Windows machine and
-  run it on your choice of X server.
+    http://fluxbox.org/
 
 Thanks:
 
@@ -46,11 +14,7 @@ Thanks:
 
   People at #fluxbox on the irc.freenode.net irc-network.
 
-  skypher of openprojects for bugtesting and providing fluxbox with
-    themes: Clean CleanColor Makro, Carbondioxide and MerleyKay.
-
-
   And all the people who sent bugfixes/patches and helped us making
-  Fluxbox a better application.
-
+  Fluxbox a better application, see AUTHORS for a incomplete list
+  of people who helped fluxbox.