add the optional 'state' parameter
added documentation for the 'state' optional option
Merge pull request #20 from akarelas/pr-state

add the optional 'state' parameter