added comments

Added some comments to the .jl functions as well as more detailed
descriptions in the README file