Update input.rst

Matt-PMCT · web-flow · commit 317eee618f6d · 2020-01-16T08:46:20.000-08:00
The documentation for the Option Input commands was not easy to follow. This leads to confusion such as in (symfony/symfony#29228). Modified to make it more clear what the different outcomes are and to provide a simple example before the condensed example.
diff --git a/console/input.rst b/console/input.rst
@@ -241,11 +241,12 @@ optionally accepts a value, but it's a bit tricky. Consider this example::
             'Should I yell while greeting?'
         );
 
-This option can be used in 3 ways: ``--yell``, ``yell=louder``, and not passing
-the option at all. However, it's hard to distinguish between passing the option
+This option can be used in 3 ways: ``greet --yell``, ``greet yell=louder``, 
+and ``greet``. However, it's hard to distinguish between passing the option 
 without a value (``greet --yell``) and not passing the option (``greet``).
 
-To solve this issue, you have to set the option's default value to ``false``::
+To solve this issue, you have to set the option's default value to 
+``false``::
 
     // ...
     use Symfony\Component\Console\Input\InputOption;
@@ -260,7 +261,32 @@ To solve this issue, you have to set the option's default value to ``false``::
             false // this is the new default value, instead of null
         );
 
-Now check the value of the option and keep in mind that ``false !== null``::
+The input will now return the default value for the option when it is not 
+specified (``greet``), a null value when it is specified but not explicitly 
+defined  (``greet --yell``), and the defined value when defined  
+(``greet --yell=lounder``). Now check the value of the option::
+
+    $optionValue = $input->getOption('yell');
+    if ($optionValue === false ) {
+        // option was not specified
+        $yell = false;
+        $yellLouder = false;        
+    } elseif ($optionValue === null) {
+        // option was specified but no value given
+        $yell = true;
+        $yellLouder = false;        
+    } else {
+        // option was specified with a value which is now stored in $optionValue
+        $yell = true;
+        if ($optionValue === 'louder') {
+            $yellLouder = true;        
+        } else {
+            $yellLouder = false;        
+        }
+    }
+
+Once you are clear on how the default value is implemented you could consense the 
+above code into less lines of code since ``false !== null``::
 
     $optionValue = $input->getOption('yell');
     $yell = ($optionValue !== false);
