diff --git a/README b/README
new file mode 100644
index 0000000..0a6ca6d
--- /dev/null
+++ b/README
@@ -0,0 +1,35 @@
+$Id$
+
+1. INTRODUCTION::
+
+     This collection of scripts collectively know as jhalfs-X, strives 
+  to create an accurate makefile directly from the xml files used to 
+  generate a specific Linux From Scratch document.
+
+     The usage of this script assumes you have read and are familiar with
+  the book and therefore the configuration variables found in conf files
+  will have meaning to you. There are a number of command line switches 
+  which, if used, will override the config file settings.
+
+  NOTES::
+  *.  The resulting Makefile takes considerable time to run to completion,
+  lay in a supply of caffeine beverages.
+
+  *.  It is recommended that you temporarily unpack your linux kernel and
+  run <make menuconfig> and configure the kernal as per the book and save
+  the resulting .config file. This configuration rule also applies to uClibc
+  when building a HLFS system using uClibc rather than glibc.
+
+2. INSTALLATION::
+     
+
+3. CONFIGURATION FILES::
+
+
+4. RUNNING::
+
+
+5. LAYOUT::
+
+     
+6. FAQ::