fix makefile, extra documentation