added defaults and changed entry function name
updated example
updated documentation