Update the README file
Improve the markdown manuals syntax
Fix the PEARL_MAN_ROOT variable