[clang] [clang-format] Add SpacesInComments option for block comments (PR #204727)

[via cfe-commits]

github-actions[bot] wrote:

<!--PREMERGE ADVISOR COMMENT: Windows-->
# :window: Windows x64 Test Results

* 54113 tests passed
* 1323 tests skipped
* 1 test failed

## Failed Tests
(click on a test name to see its output)

### Clang
<details>
<summary>Clang.Format/docs_updated.test</summary>

```
Exit Code: 1

Command Output (stdout):
--
# RUN: at line 1
"C:\Python312\python.exe" C:\_work\llvm-project\llvm-project\clang\test\Format/../../docs/tools/dump_format_style.py -o C:\_work\llvm-project\llvm-project\build\tools\clang\test\Format\Output\docs_updated.test.tmp.style
# executed command: 'C:\Python312\python.exe' 'C:\_work\llvm-project\llvm-project\clang\test\Format/../../docs/tools/dump_format_style.py' -o 'C:\_work\llvm-project\llvm-project\build\tools\clang\test\Format\Output\docs_updated.test.tmp.style'
# note: command had no output on stdout or stderr
# RUN: at line 2
diff --strip-trailing-cr C:\_work\llvm-project\llvm-project\build\tools\clang\test\Format\Output\docs_updated.test.tmp.style    C:\_work\llvm-project\llvm-project\clang\test\Format/../../docs/ClangFormatStyleOptions.rst
# executed command: diff --strip-trailing-cr 'C:\_work\llvm-project\llvm-project\build\tools\clang\test\Format\Output\docs_updated.test.tmp.style' 'C:\_work\llvm-project\llvm-project\clang\test\Format/../../docs/ClangFormatStyleOptions.rst'
# .---command stdout------------
# | *** C:\_work\llvm-project\llvm-project\build\tools\clang\test\Format\Output\docs_updated.test.tmp.style
# | --- C:\_work\llvm-project\llvm-project\clang\test\Format/../../docs/ClangFormatStyleOptions.rst
# | ***************
# | *** 7400,7434 ****
# |     This option is **deprecated**. See ``InCStyleCasts`` of
# |     ``SpacesInParensOptions``.
# |   
# | - .. _SpacesInComments:
# | - 
# | - **SpacesInComments** (``SpacesInCommentsStyle``) :versionbadge:`clang-format 23` :ref:`¶ <SpacesInComments>`
# | -   The SpacesInCommentsStyle to use for single-line ordinary block comments.
# | -   Documentation comments such as ``/** ... */`` and ``/*! ... */`` and
# | -   parameter comments ending with ``=`` before the closing ``*/`` are left
# | -   unchanged.
# | - 
# | -   Possible values:
# | - 
# | -   * ``SICS_Never`` (in configuration: ``Never``)
# | -     Remove spaces after ``/*`` and before ``*/``.
# | - 
# | -     .. code-block:: c++
# | - 
# | -        /*comment*/
# | - 
# | -   * ``SICS_Always`` (in configuration: ``Always``)
# | -     Add spaces after ``/*`` and before ``*/``.
# | - 
# | -     .. code-block:: c++
# | - 
# | -        /* comment */
# | - 
# | -   * ``SICS_Leave`` (in configuration: ``Leave``)
# | -     Leave existing spaces unchanged.
# | - 
# | - 
# | - 
# |   .. _SpacesInConditionalStatement:
# |   
# |   **SpacesInConditionalStatement** (``Boolean``) :versionbadge:`clang-format 10` :ref:`¶ <SpacesInConditionalStatement>`
# | --- 7400,7405 ----
# `-----------------------------
# error: command failed with exit status: 1

--

```
</details>

If these failures are unrelated to your changes (for example tests are broken or flaky at HEAD), please open an issue at https://github.com/llvm/llvm-project/issues and add the `infrastructure` label.

https://github.com/llvm/llvm-project/pull/204727