added comments

Added some comments to the .jl functions as well as more detailed
descriptions in the README file
Merge pull request #3 from sennosays/master

added comments