Parsed documentation:
View on GitHub
Parse a list of items, executing and gathering options along the way.
unlike parse() this method will remove any options and option arguments
from the original Array.

items - The Array of items to extract options from (default: ARGV).
block - An optional block which when used will yield non options.

Returns an Array of original items with options removed.
Please help! Open an issue on GitHub if this assessment is incorrect.