updating README and source code info, closes #5, #7, #9