more doc
better makefiles