From 7e9e5e0b5c0329ae2bd086f12174b057938a4cfd Mon Sep 17 00:00:00 2001
From: "Alex A. Naanou" <alex.nanou@gmail.com>
Date: Sun, 2 Aug 2020 19:38:36 +0300
Subject: [PATCH] docs + fixes to reporting...

Signed-off-by: Alex A. Naanou <alex.nanou@gmail.com>
---
 README.md    | 14 +++++++++-----
 argv.js      | 18 +++++++++---------
 package.json |  2 +-
 3 files changed, 19 insertions(+), 15 deletions(-)

diff --git a/README.md b/README.md
index f7c6a65..cd39b95 100644
--- a/README.md
+++ b/README.md
@@ -214,17 +214,21 @@ for example:
 
 ### Basic options
 
-These, if encountered, simply assign a value to an attribute on the parsed object.
+These, if encountered, simply assign a value to an attribute on the parsed object. 
+This attribute's name is defined by the option name (without the prefix) or by 
+setting [`<option>.arg`](#optionarg)'s `<key>`.  
 
 Any option/command can be passed a value, either explicitly (e.g. `-opt=123`) or 
-implicitly by first setting `.arg` (see examples below) and and then passing `-opt 123`.
+implicitly by first setting [`<option>.arg`](#optionarg)'s `<arg-name>` component 
+and and then passing `-opt 123`.  
+
+Option/command values can be set on the command-line as well as via 
+[`<option>.env`](./ADVANCED.md#optionenv) and/or 
+[`<option>.default`](./ADVANCED.md#optiondefault).
 
 If option is given but no value is set, `undefined` is assigned to option 
 attribute on the parsed object to indicate that the option/command is present 
 in the command-line.  
-Note that values can be set on the command-line as well as via 
-[`<option>.env`](./ADVANCED.md#optionenv) and/or 
-[`<option>.default`](./ADVANCED.md#optiondefault) see examples below.
 
 Note that repeating a basic option/command will overwrite the previous occurrences'
 value unless `.collect` is set (see `-push` example below).
diff --git a/argv.js b/argv.js
index 6a3bbf6..3da477f 100644
--- a/argv.js
+++ b/argv.js
@@ -1005,17 +1005,17 @@ object.Constructor('Parser', {
 					&& parsed.handleArgumentValue) ?
 				parsed.handleArgumentValue(handler, value)
 				: value
-			// required value check...
-			if(handler.valueRequired && value == null){
-				throw module.ParserValueError('Value missing: ${ arg }=?') }
 
-			// do not call the handler if value is implicitly undefined...
-			if(value === undefined
-					&& mode == 'implicit'){
-				return }
-			
-			// run handler...
 			try {
+				// required value check...
+				if(handler.valueRequired && value == null){
+					throw module.ParserValueError('Value missing: $ARG=?') }
+
+				// do not call the handler if value is implicitly undefined...
+				if(value === undefined
+						&& mode == 'implicit'){
+					return }
+			
 				var res = parsed.handle(handler, rest, arg, value)
 
 			// update error object with current context's arg and rest...
diff --git a/package.json b/package.json
index d5368b5..05fc745 100644
--- a/package.json
+++ b/package.json
@@ -1,6 +1,6 @@
 {
   "name": "ig-argv",
-  "version": "2.11.0",
+  "version": "2.11.1",
   "description": "simple argv parser",
   "main": "argv.js",
   "scripts": {