updated README and HOWTO