diff --git a/README.md b/README.md
index c5b3473..ed8eb55 100644
--- a/README.md
+++ b/README.md
@@ -705,6 +705,13 @@ Values that if returned by option/command handlers can control the parse flow.
   skipping `<parser>.then(..)`.
 
 
+`THEN` is useful when we want to stop option processing and trigger the 
+post-parse stage (i.e. calling `<parser>.then(..)`) for example to pass 
+the rest of the options to some other command.
+
+`STOP` is used for options like `-help` when no post-parsing is needed.
+
+
 ### `ParserError(..)` 
 
 A base error constructor. 
diff --git a/argv.js b/argv.js
index 0bfc7f1..e66b88c 100644
--- a/argv.js
+++ b/argv.js
@@ -28,10 +28,10 @@ var object = require('ig-object')
 //---------------------------------------------------------------------
 
 module.STOP = 
-	{doc: 'stop option processing, triggers .stop(..) handlers'}
+	{doc: 'Stop option processing, triggers .stop(..) handlers'}
 
 module.THEN = 
-	{doc: 'break option processing, triggers .then(..) handlers'}
+	{doc: 'Break option processing, triggers .then(..) handlers'}
 
 
 // - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -