diff --git a/AARCH64_BUILD/variables.mk b/AARCH64_BUILD/variables.mk
index b394aa2..f8d4f5f 100644
--- a/AARCH64_BUILD/variables.mk
+++ b/AARCH64_BUILD/variables.mk
@@ -2,11 +2,13 @@ export CPP_COMPILER=aarch64-buildroot-linux-gnu-g++
 
 export BD=${PWD}AARCH64_BUILD/
 
-# headers are good even if from ARM
-
-# libraries must point to the right one
 
 RESOURCES_LOC=${PWD}../../resources/
+# headers are good even if from ARM
+# libraries must point to the right one
+
+# 	for each libWWW.so.X.Y.Z
+#		ln -s /usr/lib/x..../libWWW.so.X.Y.Z /usr/lib/x..../libWWW.so
 export WAYLAND_LIBRARIES=${RESOURCES_LOC}libraries/
 export EGL_LIBRARIES=${RESOURCES_LOC}libraries/
 
diff --git a/IA64_BUILD/variables.mk b/IA64_BUILD/variables.mk
index f350f7c..92ad936 100644
--- a/IA64_BUILD/variables.mk
+++ b/IA64_BUILD/variables.mk
@@ -3,8 +3,11 @@ export CPP_COMPILER=g++
 export BD=${PWD}IA64_BUILD/
 
 # headers are good even if from ARM
-
 # libraries must point to the right one
+# probably they need to be made current
+
+# 	for each libWWW.so.X.Y.Z
+#		ln -s /usr/lib/x..../libWWW.so.X.Y.Z /usr/lib/x..../libWWW.so
 export WAYLAND_LIBRARIES=/usr/lib/x86_64-linux-gnu/
 export EGL_LIBRARIES=/usr/lib/x86_64-linux-gnu/
 
diff --git a/README b/README
deleted file mode 100644
index 6e562a1..0000000
--- a/README
+++ /dev/null
@@ -1,23 +0,0 @@
-THE EXECUTABLE MUST HAVE OWNER root AND "set user id" (chmod +s ) FLAG SET
-	( running as regular user has no rights for /dev/inputXXX , running as root breaks other stuff, so we go with owner root and setUID )
-
-
-
-
-special thanks to
-
-	https://gist.github.com/lmarz/1059f7c4101a15e2a04d6991d7b7b3d1
-
-	which provided a minimal example, allowing me to shorten the suffering of skimming through the shitty wayland documentation
-
-
-INSTALL:
-
-	run "./generate_sources.sh"
-		will generate the wayland headers and sources needed by the program
-		the generated files will be in "./wlroot_objects"
-
-	run "make"
-		will imports a bunch of definitions from "external.mk"
-		then will run "./wlroot_objects/Makefile"
-		and finally ends the build process with its own jobs
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..cfbb18f
--- /dev/null
+++ b/README.md
@@ -0,0 +1,64 @@
+#REZ_DEMO
+
+##REQUIREMENTS
+
+depends upon
+
+```
+	libmyGLUT
+		libmydevicehandler
+		libwayland-client
+		libwayland-egl
+		libGLESv2
+		libEGL
+```
+
+##BUILDING
+
+given
+
+```
+	YOURARCH={IA64|AARCH64}
+```
+
+configure the given variables for building, edit 
+
+```
+	./${YOURARCH}_BUILD/variables.mk 
+```
+
+to match the linked library locations for your building system
+
+then effectively build with
+
+```
+	ARCH=${YOURARCH} make
+```
+
+and finally give root-like permissions to the executable running
+
+```
+	# set user as root and "set user id" flag
+	sudo chown root:root ./${YOURARCH}_BUILD/main.exe
+	sudo chmod +s ./${YOURARCH}_BUILD/main.exe
+```
+( running as regular user has no rights for /dev/input/eventXXX , running as root instead breaks other stuff, so we go with owner root and setUID )
+
+
+##INSTALLING
+enable each required linked library
+
+for each libWWW.so.X.Y.Z file run
+
+```
+	${LIBRARY_LOC}=/usr/lib/x..../	# or something matching your filesystem
+	ln -s ${LIBRARY_LOC}libWWW.so.X.Y.Z ${LIBRARY_LOC}libWWW.so
+	ldconfig ${LIBRARY_LOC}
+```
+
+##CREDITS
+
+beno
+
+special thanks to [https://gist.github.com/lmarz/1059f7c4101a15e2a04d6991d7b7b3d1](https://gist.github.com/lmarz/1059f7c4101a15e2a04d6991d7b7b3d1)
+for providing a minimal example, allowing me to shorten the suffering of skimming through the shitty wayland documentation