Renamed and improved the README to README.md

Makefile

@@ -88,7 +88,7 @@ dist:
 		$(PACKAGE)-$(VERSION)/Makefile \
 		$(PACKAGE)-$(VERSION)/COPYING \
 		$(PACKAGE)-$(VERSION)/config.sh \
-		$(PACKAGE)-$(VERSION)/README \
+		$(PACKAGE)-$(VERSION)/README.md \
 		$(PACKAGE)-$(VERSION)/project.conf
 	$(RM) -- $(PACKAGE)-$(VERSION)
 

README.md

@@ -0,0 +1,22 @@
+DeforaOS libSystem
+==================
+
+About libSystem
+---------------
+
+libSystem is the most essential library within DeforaOS, with the aim to become
+a complete C runtime (thus obsoleting the libc and replacing its API).
+Regardless of its progress in this regard, libSystem is intended to be portable
+and work on any system, using any POSIX-compliant runtime provided instead.
+
+Compiling libSystem
+-------------------
+
+With GCC, this should be enough:
+
+    $ make
+
+To install libSystem in a dedicated directory, like `/path/to/libSystem`:
+
+    $ make PREFIX="/path/to/libSystem" install
+

project.conf

@@ -1,6 +1,6 @@
 package=libSystem
 version=0.1.6
 config=sh
-dist=Makefile,COPYING,config.sh,README
+dist=Makefile,COPYING,config.sh,README.md
 
 subdirs=data,doc,include,src,tests