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

    <tr>
        <th>Summary</th>
        <td>
            -Wdocumentation contains too many unrelated elements under one umbrella
        </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>
    I'm looking at enabling the `-Wdocumentation` warning on a large project and as expected this gives many violations.
To enable these warnings, it would be beneficial if a separate warning would control every category of warnings.

For example:
````
/// @param[in] i First param
/// @param[in] j
auto f(int i, int j) noexcept -> bool;
````
This outputs `2:16: warning: empty paragraph passed to '@param' command [-Wdocumentation]`

However, in our codebase, this warning gets triggered a lot since doxygen gives warnings if the param `j` is not mentioned while another parameter is documented. So to silence those warnings, these empty paragraphs are added.

Many other messages under this umbrella can be found on https://clang.llvm.org/docs/DiagnosticsReference.html#wdocumentation

</pre>
<img width="1px" height="1px" alt="" src="http://email.email.llvm.org/o/eJyEVEFv8zYM_TXyhWhgy3USH3xolwXbgF22D9uZtmhbnSwaEt00_36QnaRogWGA4RgMRT6-90SM0Q6eqFHVq6pOGS4ycmh---tlJp-1bK7Nr0ofJnDM_1g_AAqQx9albxkJ1D5_-ttwt0zkBcWyV_scLhh8ymAPCA7DQDAHfqNOAL0BjEAfM3VCBmS0EQb7ThEm9Fd4t-zWOnGn8pPKX37w1pFSv0j32lHpn8AKXHhxBlqCljz1trPowPaAEGnGgPI4cMvs2EtgB_RO4QodCg0crsD9o_Ct7_Y-cwD6wGl2pMpbTO3zz2eL6PP2gHrOU9tJVa_Wq-oEFs42RIEt-n_Zb1sGLsLQK320XsCuk3qBN6Vr8EwfHc0CT6r8GVpmp8rX_8L1I5HLi8yLxCSVVuVLsVfly33Y9EnTLNcV3xBwHmHGGJMwDEofHgj1ATqepiSfql6_a16dPrlY37_wJTG8QQdeAnRsqMVIKbSKftdlIIkgwQ4DBTLJMCwQre8IDH9cB_I3f9wFSvom763A0lhvyXM2gmeBhMmyJwOX0ToC9CwjhS2ZhEJKvIMns4M_OY0araPUUUb-5rHNdd9IioCBAI0h88UuvycLbw0nihEHirB4Q2EbeZnaQM4hdOiTZ3tevEm3ZBSZYzLY6ovOoR92zr1POw6D0mfDXVT6fLI4eI5iu_gH9RQS4t0ok1O6vHwVZEWTmaY0dVljRk2xr-s812V1yMZm36I-1mVvCm0O1aHE58Lkx2KfH_OK-hoz2-hcl0WRl3mdV9VhdzS0P5bF8VhgTUWffEETWvdAmdkYF2oORVFVmcOWXFyXitaeLrD-qbROOyY06cxTuwxRPefORomfVcSKo-abvdZLi9ZHEOZtTSw-kMO0QMhRSrzzzJ4eNGdLcM1Xagcr49LuOp6UPqeut5-n235S-rxiTXSvs_wbAAD__w6AsQQ">