[clang][docs] Fix docs-clang-html.

[abidh]

I observed that docs-clang-html is failing since #142158 with the following:

Warning, treated as error:
tools/clang/docs/DiagnosticsReference.rst:18000:Unexpected indentation. ninja: build stopped: subcommand failed.

Adding an extra empty line here fixes the build.

[llvmbot]

@llvm/pr-subscribers-clang

Author: Abid Qadeer (abidh)

Changes

I observed that docs-clang-html is failing since #142158 with the following:

Warning, treated as error:
tools/clang/docs/DiagnosticsReference.rst:18000:Unexpected indentation. ninja: build stopped: subcommand failed.

Adding an extra empty line here fixes the build.

---

Full diff: https://github.com/llvm/llvm-project/pull/142387.diff

1 Files Affected:

• (modified) clang/include/clang/Basic/DiagnosticGroups.td (+1)

diff --git a/clang/include/clang/Basic/DiagnosticGroups.td b/clang/include/clang/Basic/DiagnosticGroups.td
index 60c650583801a..0161b3953f282 100644
--- a/clang/include/clang/Basic/DiagnosticGroups.td
+++ b/clang/include/clang/Basic/DiagnosticGroups.td
@@ -821,6 +821,7 @@ As well as one of the following:
 
 The warning can be resolved by removing one of the conditions above. In rough
 order of preference, this may be done by:
+
   1. Marking the object ``const`` (if possible)
   2. Moving the object's definition to a source file
   3. Giving the object non-hidden visibility, e.g. using ``__attribute((visibility("default")))``.

[abidh]

I see that https://clang.llvm.org/docs/DiagnosticsReference.html#wunique-object-duplication is showing this correctly without this PR so problem may be something local to my machine. Closing it for now.

[Mr-Anyone]

I think I am seeing something similar on CI:

https://github.com/llvm/llvm-project/actions/runs/15387162550/job/43288136977?pr=140278

[abidh]

I think I am seeing something similar on CI:

https://github.com/llvm/llvm-project/actions/runs/15387162550/job/43288136977?pr=140278

Thanks for reporting this. I think I will reopen it.

[frederick-vs-ja]

I wonder whether it would be better to modify .github/workflows/docs.yml together. It seems that modification of some transitively included td files doesn't trigger CI for documentation.

[ojhunt]

this is tripping on CI and my machine.

To repro I need to delete $BUILD_DIR/tools/clang/docs and build with TZ=UTC ninja docs-clang-man

I find it necessary to delete the doc directory to trigger this.