makefile minor fix
add lots of documentation