Replace incorrect javadoc.
Change method signature: request array instead of list iterator.
Fix tokens vs. arguments
Method signature change: token iterator now provides option token.
A token iterator provides strings.
Code style improvements.
Fix code example in README.