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

    <tr>
        <th>Summary</th>
        <td>
            [clang-format] Add target language & standard to the documentation
        </td>
    </tr>

    <tr>
      <th>Labels</th>
      <td>
            documentation
      </td>
    </tr>

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

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

<pre>
    Sometimes we waste some time thinking about whether a new check is relevant for us. For example, the [`AllowShortCaseExpressionOnASingleLine`](https://clang.llvm.org/docs/ClangFormatStyleOptions.html#allowshortcaseexpressiononasingleline) option was added in Clang-Format 19. As a C++ developer, I was not familiar with the syntax, so I first looked to see if it was a language construct from a newer standard that I was not yet familiar with (e.g. C++26). It wasn't until I took a look at the source code, or the PR for it (#91112), that I saw that this option is apparently Java-specific and therefore not relevant for us.

It would therefore be practical if the languages were included in the documentation, e.g. via:
In case it is for all languages it could be `Languages: all` (I think there should be a badge even in this case, so it is clear, that no one missed to document this).

In case of specific required versions of the standard, it could look like this:

</pre>
<img width="1" height="1" alt="" src="http://email.email.llvm.org/o/eJysVMtu6zYTfhp6M5BBUbdo4YWT8xvwjwOconmCETmS2FCkS1L2ydsXpOycIC266koCL_PNd-FgCHqyRAfWPLPm2w7XODt_eF3ts0H5thucej-8uoWiXijAjeCGIRIEtxCkNYiztm_aToCDWyPcZoozeUCwdAM5k3wDHcCToSvaCKPzsIY9nJwH-onLxRATLxBngtRCy4_GuNvr7Hx8wUD_-3nxFIJ29oc9vmo7GfquLbGWs-YbE09zjJfAqiMTJyZO0qCd9sZcl73zExMn5WRg4vSS1k_OLxhf47uhH5eonQ37OS6GiQoTZEiQEgPRB6SzGDKkSZCiB5fvJQkAlSIF2kKuXWzFoez3cAyA8MLEMxPPoOhKxl3IJ5LnfNO6CCMu2mj0cNNxzuTDu434M50KDs4wah8iGOfeSEF0EIhAj6DjBg4JdMWJQDobol9lhNG7ZZOdPISIVqFXEGeMn4Df6Ss4E0-0n_aPjkXLRL-HcwayTHQRVhu1gTNE594SdP7ErWu3epmaUNlF5_Pqb79nm3VMxZmo-rIsBRP9ZnTuJ-Bt-42zDg9ddQC8XNCTjeYd_o9XLMKFpB61BLSJC3kanadM5WukGD8yfkyNu9V8PjwQXDzKqCWaJGJq8aFfirQn0Faa9W5o2lZOrgvZiKmv1HaW6KoxRY0fmShZ83xecKJ_iuGk47wOe-kWJk5rIF9gjCjnVDHFEUOg_CP4wNVQVQXyti_qrquKoeeqGGmsFLVPqlZV0o0fzxZSNpOmOmTGaMwnFjqCzLQHAtby748NVh3TSdby5MV5e62bNhDmxw2EAdVEQFeymwQ6ZLx7HjdUaQj9h4fWgbMEiw5hi-hDs3w7hehuyL1zN8KHmZ7-XLUnBVfy6aGFtJvzdI9tQvmglANn9BttlTcH_jsTKt633diLYsBWFvWIbdGXXV1IPjZlxZ9IjgMT_U4dKtVXPe7oUHZ11XVdx8VuPvQDb586bMtajEPf923TiLFqSbVNPUiinT4ILhpe87qs67IW-6Gtuuap6odG1QOVJas5LajNx-Ta6RBWOpRVXfV8Z3AgE_KEFuJLMkUa2v6QLhbDOgVWc6NDDL9KRR1NHu95OBZjHlSs-QZHpSCinyj-miZMtJ9Gh_v7W9it3hz-RegEe_8UF-_-IBmZOGU6Ses7o-tB_BUAAP__YKwolw">