common-cli: arguments parsing improvement

Can you add some more detailed javadocs explaining what `Parser.parseInput` and `Parser.parsePattern` do? I see there is some, but those don't explain what the output actually is.