diff --git a/README b/README
new file mode 100644
index 0000000000000000000000000000000000000000..d369954122822adb0ae8dd40c971bc73dd4c0f10
--- /dev/null
+++ b/README
@@ -0,0 +1,54 @@
+Datadec takes recursive data types modelled on those found in functional
+languages (Hope, Miranda, Haskell etc) and generates ANSI C code to
+implement them.
+
+			Duncan C. White, dcw@doc.ic.ac.uk
+			19th March 2002
+
+Building and Packaging on Linux
+-----------------
+
+Either download http://csgsoft.doc.ic.ac.uk/datadec/datadec-1.0-1.i386.rpm
+and install it (rpm -i) from there, or do a source build:
+
+1. Download the datadec-1.0.tgz file and save it in your RPM SOURCES directory.
+
+2. Extract the package SPEC file:
+   
+	tar xzf datadec-1.0.tgz datadec-1.0/PKG/RPM
+
+3. Enter the directory and build the package:
+
+	cd datadec-1.0/PKG/RPM
+	rpm -bb datadec.spec
+
+4. Now you can install the datadec-1.0-1.is386.rpm that you just built,
+   using rpm -i..
+
+
+Building on Solaris or Other Unices
+-----------------------------------
+
+1. Extract the .tgz file..
+
+2. Compile it:
+
+	cd datadec-1.0
+	make
+
+3. Install it (run this as root) into /usr/local/bin and /usr/man/man1:
+
+	make install
+
+4. (Optionally on Solaris) package it up and store in somewhere:
+
+	cd PKG/Solaris
+	make
+
+	(edit Makefile, changing where to store the built package)
+
+	make install
+
+5. install the package (as root):
+
+	pkgadd -d datadec-1.0-1-sol8-sparc-dcw all