docs: ordering of positional and option does not matter (#46)

* docs: ordering of positional and option does not matter

* Add test to match README FAQ

Author: shadowspawn

README.md

@@ -150,7 +150,7 @@ const { flags, values, positionals } = parseArgs(argv, options);
 ### F.A.Qs
 
 - Is `cmd --foo=bar baz` the same as `cmd baz --foo=bar`?
-  - Yes, if `withValue: ['foo']`, otherwise no
+  - yes
 - Does the parser execute a function?
   - no
 - Does the parser execute one of several functions, depending on input?

test/index.js

@@ -228,6 +228,18 @@ test('args are passed "withValue" and "multiples"', function(t) {
   t.end();
 });
 
+test('order of option and positional does not matter (per README)', function(t) {
+  const passedArgs1 = ['--foo=bar', 'baz'];
+  const passedArgs2 = ['baz', '--foo=bar'];
+  const passedOptions = { withValue: ['foo'] };
+  const expected = { flags: { foo: true }, values: { foo: 'bar' }, positionals: ['baz'] };
+
+  t.deepEqual(parseArgs(passedArgs1, passedOptions), expected, 'option then positional');
+  t.deepEqual(parseArgs(passedArgs2, passedOptions), expected, 'positional then option');
+
+  t.end();
+});
+
 test('correct default args when use node -p', function(t) {
   const holdArgv = process.argv;
   process.argv = [process.argv0, '--foo'];