Some improvements in the README file to keep it in sync with the latest code
developments.