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

    <tr>
        <th>Summary</th>
        <td>
            Conflicting Warnings -Wdocumentation and -Wunused-parameter for ignored parameters
        </td>
    </tr>

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

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

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

<pre>
    Consider this snippet: https://compiler-explorer.com/z/4dWb78jhY
Which of these declarations are idiomatically 'correct'?

I would like do explicitly state within my implementation's documentation comment that a function parameter is ignored.
Therefore, I would expect that `Impl2` compiles without warning, accepting any argument to `@param` when the corresponding function argument is not named. However, not documenting that parameter at all seems to be the only way to get no warning.
</pre>
<img width="1px" height="1px" alt="" src="http://email.email.llvm.org/o/eJxUU01vozwQ_jXmMkrkGAjhwKFvK_T2vlK0R2MPMF1jI9uUsr9-ZZI06gXEoHm-9IwMgQaL2LDyP1a-ZXKJo_NNiOgj2QFt1jm9Na_OBtLoIY4UIFiaZ4wsf4Exxjmw_IWJlolWuWkmg_6AX7NxHv1RuYmJ9i8TbaGvXXX5GH8z_sb4y3UkNYLrIY4YEDQqI72M5GwA6RFIk5tkJCWN2YCJSjnvUUUmKpa3N4zb8x1WtxgNhv4gaAeJmxRFs0GIMiKsFEeyMG1A02xwQht3IiaqANqp5XsCyk3pA-IoI0joF6v2-Sy9nDCiBwpAg3Ue9fFG_2tEj73zyMQrPLTg14zqDsPO_H2ajWBnDveAwq7JLRFW6S3ZIe1KpXBOoYO0G0g_LDcpLiGwgu8aEsg6ok2xwR5JmJ3Vaetb7PcqBbAugpUT6iP871b8RJ-o0vRhPK3uOp8ek3djICBOIfF3uNM5azZY5ZZGA0aw7iH_mOkm13VeywybU8WLy6kscp6NTXmSolRnLbWui_qcq75X9UVhx88Fr7HIqBFcFPzE61NZ8pwfJS8Ur3jVo-b1WZxYwXGSZI7GfE5H54eMQliwqariUmdGdmjC3l4hLK6w_2RCpDL7Ju0cumUIrOCGQgxPlEjRYCp2b0jtKVxvZgIcrj9bIa2Gw3WxS0B9eMbUO__owjO8kC3eND_PYqA4Lt39FpKA--swe_exd7rdZQcm2t3WvwAAAP__80k7Lw">