From 73156646a6c30c69418095efae528d9acf9e0c64 Mon Sep 17 00:00:00 2001
From: Lopton <mattework@yahoo.com>
Date: Thu, 16 Jan 2020 08:46:20 -0800
Subject: [PATCH] Update input.rst

The documentation for the Option Input commands was not easy to follow. This leads to confusion such as in (https://github.com/symfony/symfony/issues/29228). Modified to make it more clear what the different outcomes are and to provide a simple example before the condensed example.
---
 console/input.rst | 34 ++++++++++++++++++++++++++++++----
 1 file changed, 30 insertions(+), 4 deletions(-)

diff --git a/console/input.rst b/console/input.rst
index 737ceb62ca1..0c64d93956a 100644
--- a/console/input.rst
+++ b/console/input.rst
@@ -247,11 +247,12 @@ optionally accepts a value, but it's a bit tricky. Consider this example::
         )
     ;
 
-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;
@@ -267,7 +268,32 @@ To solve this issue, you have to set the option's default value to ``false``::
         )
     ;
 
-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);