[clang-tools-extra] [clang-doc] Flatten repeated @return and @brief comment arrays (PR #188739)
via cfe-commits
cfe-commits at lists.llvm.org
Fri Apr 3 13:45:33 PDT 2026
github-actions[bot] wrote:
<!--PREMERGE ADVISOR COMMENT: Windows-->
# :window: Windows x64 Test Results
* 3110 tests passed
* 30 tests skipped
* 2 tests failed
## Failed Tests
(click on a test name to see its output)
### Clang Tools
<details>
<summary>Clang Tools.clang-doc/enum.cpp</summary>
```
Exit Code: 1
Command Output (stdout):
--
# RUN: at line 1
rm -rf C:\_work\llvm-project\llvm-project\build\tools\clang\tools\extra\test\clang-doc\Output\enum.cpp.tmp && mkdir -p C:\_work\llvm-project\llvm-project\build\tools\clang\tools\extra\test\clang-doc\Output\enum.cpp.tmp
# executed command: rm -rf 'C:\_work\llvm-project\llvm-project\build\tools\clang\tools\extra\test\clang-doc\Output\enum.cpp.tmp'
# note: command had no output on stdout or stderr
# executed command: mkdir -p 'C:\_work\llvm-project\llvm-project\build\tools\clang\tools\extra\test\clang-doc\Output\enum.cpp.tmp'
# note: command had no output on stdout or stderr
# RUN: at line 2
clang-doc --format=html --doxygen --output=C:\_work\llvm-project\llvm-project\build\tools\clang\tools\extra\test\clang-doc\Output\enum.cpp.tmp --executor=standalone C:\_work\llvm-project\llvm-project\clang-tools-extra\test\clang-doc/Inputs/enum.cpp
# executed command: clang-doc --format=html --doxygen '--output=C:\_work\llvm-project\llvm-project\build\tools\clang\tools\extra\test\clang-doc\Output\enum.cpp.tmp' --executor=standalone 'C:\_work\llvm-project\llvm-project\clang-tools-extra\test\clang-doc/Inputs/enum.cpp'
# .---command stdout------------
# | Emiting docs in html format.
# | Mapping decls...
# | Collecting infos...
# | Reducing 4 infos...
# | Generating docs...
# | Generating assets for docs...
# `-----------------------------
# .---command stderr------------
# | Error while trying to load a compilation database:
# | Could not auto-detect compilation database for file "C:\_work\llvm-project\llvm-project\clang-tools-extra\test\clang-doc/Inputs/enum.cpp"
# | No compilation database found in C:\_work\llvm-project\llvm-project\clang-tools-extra\test\clang-doc\Inputs or any parent directory
# | fixed-compilation-database: Error while opening fixed database: no such file or directory
# | json-compilation-database: Error while opening JSON database: no such file or directory
# | Running without flags.
# `-----------------------------
# RUN: at line 3
clang-doc --format=md --doxygen --output=C:\_work\llvm-project\llvm-project\build\tools\clang\tools\extra\test\clang-doc\Output\enum.cpp.tmp --executor=standalone C:\_work\llvm-project\llvm-project\clang-tools-extra\test\clang-doc/Inputs/enum.cpp
# executed command: clang-doc --format=md --doxygen '--output=C:\_work\llvm-project\llvm-project\build\tools\clang\tools\extra\test\clang-doc\Output\enum.cpp.tmp' --executor=standalone 'C:\_work\llvm-project\llvm-project\clang-tools-extra\test\clang-doc/Inputs/enum.cpp'
# .---command stdout------------
# | Emiting docs in md format.
# | Mapping decls...
# | Collecting infos...
# | Reducing 4 infos...
# | Generating docs...
# | Generating assets for docs...
# `-----------------------------
# .---command stderr------------
# | Error while trying to load a compilation database:
# | Could not auto-detect compilation database for file "C:\_work\llvm-project\llvm-project\clang-tools-extra\test\clang-doc/Inputs/enum.cpp"
# | No compilation database found in C:\_work\llvm-project\llvm-project\clang-tools-extra\test\clang-doc\Inputs or any parent directory
# | fixed-compilation-database: Error while opening fixed database: no such file or directory
# | json-compilation-database: Error while opening JSON database: no such file or directory
# | Running without flags.
# `-----------------------------
# RUN: at line 4
clang-doc --format=md_mustache --doxygen --output=C:\_work\llvm-project\llvm-project\build\tools\clang\tools\extra\test\clang-doc\Output\enum.cpp.tmp --executor=standalone C:\_work\llvm-project\llvm-project\clang-tools-extra\test\clang-doc/Inputs/enum.cpp
# executed command: clang-doc --format=md_mustache --doxygen '--output=C:\_work\llvm-project\llvm-project\build\tools\clang\tools\extra\test\clang-doc\Output\enum.cpp.tmp' --executor=standalone 'C:\_work\llvm-project\llvm-project\clang-tools-extra\test\clang-doc/Inputs/enum.cpp'
# .---command stdout------------
# | Emiting docs in md_mustache format.
# | Mapping decls...
# | Collecting infos...
# | Reducing 4 infos...
# | Generating docs...
# | Generating assets for docs...
# `-----------------------------
# .---command stderr------------
# | Error while trying to load a compilation database:
# | Could not auto-detect compilation database for file "C:\_work\llvm-project\llvm-project\clang-tools-extra\test\clang-doc/Inputs/enum.cpp"
# | No compilation database found in C:\_work\llvm-project\llvm-project\clang-tools-extra\test\clang-doc\Inputs or any parent directory
# | fixed-compilation-database: Error while opening fixed database: no such file or directory
# | json-compilation-database: Error while opening JSON database: no such file or directory
# | Running without flags.
# `-----------------------------
# RUN: at line 5
FileCheck C:\_work\llvm-project\llvm-project\clang-tools-extra\test\clang-doc\enum.cpp < C:\_work\llvm-project\llvm-project\build\tools\clang\tools\extra\test\clang-doc\Output\enum.cpp.tmp/html/GlobalNamespace/index.html --check-prefix=HTML-INDEX
# executed command: FileCheck 'C:\_work\llvm-project\llvm-project\clang-tools-extra\test\clang-doc\enum.cpp' --check-prefix=HTML-INDEX
# note: command had no output on stdout or stderr
# RUN: at line 6
FileCheck C:\_work\llvm-project\llvm-project\clang-tools-extra\test\clang-doc\enum.cpp < C:\_work\llvm-project\llvm-project\build\tools\clang\tools\extra\test\clang-doc\Output\enum.cpp.tmp/html/GlobalNamespace/_ZTV7Animals.html --check-prefix=HTML-ANIMAL
# executed command: FileCheck 'C:\_work\llvm-project\llvm-project\clang-tools-extra\test\clang-doc\enum.cpp' --check-prefix=HTML-ANIMAL
# note: command had no output on stdout or stderr
# RUN: at line 7
FileCheck C:\_work\llvm-project\llvm-project\clang-tools-extra\test\clang-doc\enum.cpp < C:\_work\llvm-project\llvm-project\build\tools\clang\tools\extra\test\clang-doc\Output\enum.cpp.tmp/html/GlobalNamespace/_ZTV15FilePermissions.html --check-prefix=HTML-PERM
# executed command: FileCheck 'C:\_work\llvm-project\llvm-project\clang-tools-extra\test\clang-doc\enum.cpp' --check-prefix=HTML-PERM
# note: command had no output on stdout or stderr
# RUN: at line 8
FileCheck C:\_work\llvm-project\llvm-project\clang-tools-extra\test\clang-doc\enum.cpp < C:\_work\llvm-project\llvm-project\build\tools\clang\tools\extra\test\clang-doc\Output\enum.cpp.tmp/html/Vehicles/index.html --check-prefix=HTML-VEHICLES
# executed command: FileCheck 'C:\_work\llvm-project\llvm-project\clang-tools-extra\test\clang-doc\enum.cpp' --check-prefix=HTML-VEHICLES
# note: command had no output on stdout or stderr
# RUN: at line 9
FileCheck C:\_work\llvm-project\llvm-project\clang-tools-extra\test\clang-doc\enum.cpp < C:\_work\llvm-project\llvm-project\build\tools\clang\tools\extra\test\clang-doc\Output\enum.cpp.tmp/GlobalNamespace/index.md --check-prefix=MD-INDEX
# executed command: FileCheck 'C:\_work\llvm-project\llvm-project\clang-tools-extra\test\clang-doc\enum.cpp' --check-prefix=MD-INDEX
# note: command had no output on stdout or stderr
# RUN: at line 10
FileCheck C:\_work\llvm-project\llvm-project\clang-tools-extra\test\clang-doc\enum.cpp < C:\_work\llvm-project\llvm-project\build\tools\clang\tools\extra\test\clang-doc\Output\enum.cpp.tmp/GlobalNamespace/Animals.md --check-prefix=MD-ANIMAL
# executed command: FileCheck 'C:\_work\llvm-project\llvm-project\clang-tools-extra\test\clang-doc\enum.cpp' --check-prefix=MD-ANIMAL
# note: command had no output on stdout or stderr
# RUN: at line 11
FileCheck C:\_work\llvm-project\llvm-project\clang-tools-extra\test\clang-doc\enum.cpp < C:\_work\llvm-project\llvm-project\build\tools\clang\tools\extra\test\clang-doc\Output\enum.cpp.tmp/GlobalNamespace/FilePermissions.md --check-prefix=MD-PERM
# executed command: FileCheck 'C:\_work\llvm-project\llvm-project\clang-tools-extra\test\clang-doc\enum.cpp' --check-prefix=MD-PERM
# note: command had no output on stdout or stderr
# RUN: at line 12
FileCheck C:\_work\llvm-project\llvm-project\clang-tools-extra\test\clang-doc\enum.cpp < C:\_work\llvm-project\llvm-project\build\tools\clang\tools\extra\test\clang-doc\Output\enum.cpp.tmp/Vehicles/index.md --check-prefix=MD-VEHICLES
# executed command: FileCheck 'C:\_work\llvm-project\llvm-project\clang-tools-extra\test\clang-doc\enum.cpp' --check-prefix=MD-VEHICLES
# note: command had no output on stdout or stderr
# RUN: at line 13
FileCheck C:\_work\llvm-project\llvm-project\clang-tools-extra\test\clang-doc\enum.cpp < C:\_work\llvm-project\llvm-project\build\tools\clang\tools\extra\test\clang-doc\Output\enum.cpp.tmp/md/GlobalNamespace/index.md --check-prefix=MD-MUSTACHE-INDEX
# executed command: FileCheck 'C:\_work\llvm-project\llvm-project\clang-tools-extra\test\clang-doc\enum.cpp' --check-prefix=MD-MUSTACHE-INDEX
# note: command had no output on stdout or stderr
# RUN: at line 14
FileCheck C:\_work\llvm-project\llvm-project\clang-tools-extra\test\clang-doc\enum.cpp < C:\_work\llvm-project\llvm-project\build\tools\clang\tools\extra\test\clang-doc\Output\enum.cpp.tmp/md/GlobalNamespace/_ZTV7Animals.md --check-prefix=MD-MUSTACHE-ANIMAL
# executed command: FileCheck 'C:\_work\llvm-project\llvm-project\clang-tools-extra\test\clang-doc\enum.cpp' --check-prefix=MD-MUSTACHE-ANIMAL
# note: command had no output on stdout or stderr
# RUN: at line 15
FileCheck C:\_work\llvm-project\llvm-project\clang-tools-extra\test\clang-doc\enum.cpp < C:\_work\llvm-project\llvm-project\build\tools\clang\tools\extra\test\clang-doc\Output\enum.cpp.tmp/md/Vehicles/index.md --check-prefix=MD-MUSTACHE-VEHICLES
# executed command: FileCheck 'C:\_work\llvm-project\llvm-project\clang-tools-extra\test\clang-doc\enum.cpp' --check-prefix=MD-MUSTACHE-VEHICLES
# note: command had no output on stdout or stderr
# RUN: at line 16
FileCheck C:\_work\llvm-project\llvm-project\clang-tools-extra\test\clang-doc\enum.cpp < C:\_work\llvm-project\llvm-project\build\tools\clang\tools\extra\test\clang-doc\Output\enum.cpp.tmp/json/GlobalNamespace/index.json --check-prefix=JSON-INDEX
# executed command: FileCheck 'C:\_work\llvm-project\llvm-project\clang-tools-extra\test\clang-doc\enum.cpp' --check-prefix=JSON-INDEX
# .---command stderr------------
# | C:\_work\llvm-project\llvm-project\clang-tools-extra\test\clang-doc\enum.cpp:25:21: error: JSON-INDEX-NEXT: is not on the line after the previous match
# | // JSON-INDEX-NEXT: [
# | ^
# | <stdin>:19:13: note: 'next' match was here
# | "Members": [
# | ^
# | <stdin>:6:20: note: previous match ended here
# | "BriefComments": [
# | ^
# | <stdin>:7:1: note: non-matching line after previous match is here
# | {
# | ^
# |
# | Input file: <stdin>
# | Check file: C:\_work\llvm-project\llvm-project\clang-tools-extra\test\clang-doc\enum.cpp
# |
# | -dump-input=help explains the following input dump.
# |
# | Input was:
# | <<<<<<
# | .
# | .
# | .
# | 14: "InfoType": "enum",
# | 15: "Location": {
# | 16: "Filename": "C:\\_work\\llvm-project\\llvm-project\\clang-tools-extra\\test\\clang-doc\\Inputs\\enum.cpp",
# | 17: "LineNumber": 4
# | 18: },
# | 19: "Members": [
# | next:25 ! error: match on wrong line
# | 20: {
# | 21: "Description": {
# | 22: "HasParagraphComments": true,
# | 23: "ParagraphComments": [
# | 24: [
# | .
# | .
# | .
# | >>>>>>
# `-----------------------------
# error: command failed with exit status: 1
--
```
</details>
<details>
<summary>Clang Tools.clang-doc/json/class.cpp</summary>
```
Exit Code: 1
Command Output (stdout):
--
# RUN: at line 1
rm -rf C:\_work\llvm-project\llvm-project\build\tools\clang\tools\extra\test\clang-doc\json\Output\class.cpp.tmp && mkdir -p C:\_work\llvm-project\llvm-project\build\tools\clang\tools\extra\test\clang-doc\json\Output\class.cpp.tmp
# executed command: rm -rf 'C:\_work\llvm-project\llvm-project\build\tools\clang\tools\extra\test\clang-doc\json\Output\class.cpp.tmp'
# note: command had no output on stdout or stderr
# executed command: mkdir -p 'C:\_work\llvm-project\llvm-project\build\tools\clang\tools\extra\test\clang-doc\json\Output\class.cpp.tmp'
# note: command had no output on stdout or stderr
# RUN: at line 2
clang-doc --output=C:\_work\llvm-project\llvm-project\build\tools\clang\tools\extra\test\clang-doc\json\Output\class.cpp.tmp --format=html --executor=standalone C:\_work\llvm-project\llvm-project\clang-tools-extra\test\clang-doc\json\class.cpp
# executed command: clang-doc '--output=C:\_work\llvm-project\llvm-project\build\tools\clang\tools\extra\test\clang-doc\json\Output\class.cpp.tmp' --format=html --executor=standalone 'C:\_work\llvm-project\llvm-project\clang-tools-extra\test\clang-doc\json\class.cpp'
# .---command stdout------------
# | Emiting docs in html format.
# | Mapping decls...
# | Collecting infos...
# | Reducing 4 infos...
# | Generating docs...
# | Generating assets for docs...
# `-----------------------------
# .---command stderr------------
# | Error while trying to load a compilation database:
# | Could not auto-detect compilation database for file "C:\_work\llvm-project\llvm-project\clang-tools-extra\test\clang-doc\json\class.cpp"
# | No compilation database found in C:\_work\llvm-project\llvm-project\clang-tools-extra\test\clang-doc\json or any parent directory
# | fixed-compilation-database: Error while opening fixed database: no such file or directory
# | json-compilation-database: Error while opening JSON database: no such file or directory
# | Running without flags.
# `-----------------------------
# RUN: at line 3
FileCheck C:\_work\llvm-project\llvm-project\clang-tools-extra\test\clang-doc\json\class.cpp < C:\_work\llvm-project\llvm-project\build\tools\clang\tools\extra\test\clang-doc\json\Output\class.cpp.tmp/json/GlobalNamespace/_ZTV7MyClass.json
# executed command: FileCheck 'C:\_work\llvm-project\llvm-project\clang-tools-extra\test\clang-doc\json\class.cpp'
# .---command stderr------------
# | C:\_work\llvm-project\llvm-project\clang-tools-extra\test\clang-doc\json\class.cpp:53:16: error: CHECK-NEXT: is not on the line after the previous match
# | // CHECK-NEXT: [
# | ^
# | <stdin>:20:23: note: 'next' match was here
# | "ParagraphComments": [
# | ^
# | <stdin>:13:20: note: previous match ended here
# | "BriefComments": [
# | ^
# | <stdin>:14:1: note: non-matching line after previous match is here
# | {
# | ^
# |
# | Input file: <stdin>
# | Check file: C:\_work\llvm-project\llvm-project\clang-tools-extra\test\clang-doc\json\class.cpp
# |
# | -dump-input=help explains the following input dump.
# |
# | Input was:
# | <<<<<<
# | .
# | .
# | .
# | 15: "TextComment": "This is a brief description."
# | 16: }
# | 17: ],
# | 18: "HasBriefComments": true,
# | 19: "HasParagraphComments": true,
# | 20: "ParagraphComments": [
# | next:53 ! error: match on wrong line
# | 21: [
# | 22: {
# | 23: "TextComment": "This is a nice class."
# | 24: },
# | 25: {
# | .
# | .
# | .
# | >>>>>>
# `-----------------------------
# 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/188739
More information about the cfe-commits
mailing list