updated documentation for sphinx directive
fixed optional positional arguments in sphinx directive
Merge pull request #20 from lovelysystems/autodoc_docu

updated documentation for sphinx directive