add documentation about positional arguments, fix #8