README and comment improvements
Added validation of calling parameters