added documentation about YAML format in the manual
fixed an issue with the Makefile