Update the documentation to match the behaviour

This functionality is already tested in
https://github.com/davetron5000/gli/blob/gli-2/test/tc_gli.rb#L347