<table border="1" cellspacing="0" cellpadding="8">
    <tr>
        <th>Issue</th>
        <td>
            <a href=https://github.com/llvm/llvm-project/issues/129671>129671</a>
        </td>
    </tr>

    <tr>
        <th>Summary</th>
        <td>
            Confusing behaviour command line options with default value 'true'
        </td>
    </tr>

    <tr>
      <th>Labels</th>
      <td>
            new issue
      </td>
    </tr>

    <tr>
      <th>Assignees</th>
      <td>
      </td>
    </tr>

    <tr>
      <th>Reporter</th>
      <td>
          JVApen
      </td>
    </tr>
</table>

<pre>
    In clang-include-cleaner, there are some options that have a default value 'true'.

For example:
https://github.com/llvm/llvm-project/blob/03505a004ff6909c46d6b8c498a9ffccd47d88a0/clang-tools-extra/include-cleaner/tool/IncludeCleaner.cpp#L100-L105

When using the --help for it, it tells the following:
````
USAGE: clang-include-cleaner.exe [options] <source0> [... <sourceN>]

OPTIONS:
 ...
  --remove                    - Allow header removals
  --version - Display the version of this program
````
This seems to imply that you have to add '--remove' in order to active the example option.
However, this is enabled by default. If you don't want the 'removal' behavior, you have to add `--remove=false` to the command line. This is nowhere to be found in the help message.

Can the command line output be improved such that default options are somehow indicated and it is easy to see how to disable them? For example ` --remove      - Allow header removals (Default, use --remove=false to disable)`
</pre>
<img width="1" height="1" alt="" src="http://email.email.llvm.org/o/eJyUVMGOozgQ_RrnUgIZAyEcOGSSZrdXo5mVpnf3bOwieGVsZJuk8_crQ9gedc8cJoqUqMqueu_5VXHv1cUgNqT8RMrzjs9hsK754-_jhGbXWXlvng0Izc0lUUboWWIiNHKDjrAThAEdAncI3o4IdgrKGg9h4AEGfkXgILHnsw5w5XpGIKwKbkbCqpTQI6HH1jrAVz5OGkkeA0MIk49_WUtYe1FhmLtU2JGwVuvr9pNMzv6LIhDWdtp2hLU0L2nJKS36fl_TWhR7ue8OoqgPvO57IWRRycOBU8LalU6wVvsEX4PjhLUfyLUxT1j7vCZOazwV00RY_jmjNPmc0XIl8c-ABmavzCUqAkkyoJ6gtw5UiDKpAAG19ku2t1rbmzKXlS_Z07cvPf717fjbE8mPP9Y8xVcEUn56CE3KM5D85O3sBFKSP8VcmqZvwS8kfyLleYX59c-X569fvq19IU3jEwAkicPRXhF-8EngGMHCgFyig-Ug1_5x74rOK2sggbPyk-b3hd8WtT2EQXmYnL04Pn6k-hKzHnH0ECyocdL31Tl3O6_uCRa4lNE0G0jCKlAGrItwYloEFQ8OuLnoYcLI7Xd7w-tmVOVBeUDDO40SuvtmzBSe-6WjtCa6E27chKUgYdWDcOza4cCvyi7VPgDc0_8B5ueea49kT2M21hF2HLmRoJXBFF4eSIy9LcMTLHTRFLORkVm8sLhnRO_5BR9jcuLmQy2wc5jmEK-rcXL2ihL8LIZVxG3utpnchnSwN1BGKsEDSoi1VFiU4f4ewXhEiGeCBal8VCs2HknewnezGim_c85PvAKEHc4rlijd7BHea_VdL8Jqsqc72eSyzmu-wyarioxWh5pmu6EpK1HtO8ErFBnnmGW5ELLs8qqWgmUd26mGUVbSnBa0plmRpRTz7MArmdGsr1EUpKA4cqXTuEVS6y475f2MTcbqfZXtNO9Q-2UbMmbwBkuWMBaXo2uW1dPNF08KqpUP_q1MUEFjc7KmXxfBwy-ze_dmj-e4qTD8dDfuZqebX16EC1RPWPvgcm3YfwEAAP__9Tzprg">