updated the README file (refs #721)
fixed markup