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

    <tr>
        <th>Summary</th>
        <td>
            Build failure when generating Sphinx documentation
        </td>
    </tr>

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

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

    <tr>
      <th>Reporter</th>
      <td>
          m-saito-fj
      </td>
    </tr>
</table>

<pre>
    The following three files have errors when generating documentation using Sphinx.

1. llvm/docs/SpeculativeLoadHardening.md
2. clang/docs/ReleaseNotes.rst
3. llvm/docs/AMDGPUDwarfExtensionAllowLocationDescriptionOnTheDwarfExpressionStack/AMDGPUDwarfExtensionAllowLocationDescriptionOnTheDwarfExpressionStack.md

- Error message for the first file
> [37/1109] Generating man Sphinx documentation for llvm-dwarfdump into "build/docs/man"
> FAILED: docs/CMakeFiles/docs-llvm-dwarfdump-man docs/CMakeFiles/docs-llvm-dwarfdump-man
> cd build/docs && /usr/bin/cmake -E env /usr/bin/sphinx-build -b man -d build/docs/_doctrees-llvm-dwarfdump-man -q -t builder-man -D version=18 -D release=18.0.0git -tPreRelease -W llvm-project/llvm/docs build/docs/man
> 
> Warning, treated as error:
> llvm-project/llvm/docs/SpeculativeLoadHardening.md:3:Non-consecutive header level increase; H1 to H3 [myst.header]

- Error message for the second file
> [378/600] Generating man Sphinx documentation for clang into "build/tools/clang/docs/man" FAILED: tools/clang/docs/CMakeFiles/docs-clang-man build/tools/clang/docs/CMakeFiles/docs-clang-man
> cd build/tools/clang/docs && /usr/bin/cmake -E env /usr/bin/sphinx-build -b man -d build/tools/clang/docs/_doctrees-clang-man -q -t builder-man -D version=18 -D release=18.0.0git -tPreRelease -W build/tools/clang/docs build/tools/clang/docs/man
> 
> Warning, treated as error:
> build/tools/clang/docs/ReleaseNotes.rst:595:Bullet list ends without a blank line; unexpected unindent.

 
- Error message for the third file
> [11/11] Generating html Sphinx documentation for llvm into "build/docs/html" FAILED: docs/CMakeFiles/docs-llvm-html build/docs/CMakeFiles/docs-llvm-html
> cd build/docs && /usr/bin/cmake -E env /usr/bin/sphinx-build -b html -d build/docs/_doctrees-llvm-html -q -t builder-html -D version=18 -D release=18.0.0git -tPreRelease -W llvm-project/llvm/docs build/docs/html
> 
> Warning, treated as error:
> llvm-project/llvm/docs/AMDGPUDwarfExtensionAllowLocationDescriptionOnTheDwarfExpressionStack/AMDGPUDwarfExtensionAllowLocationDescriptionOnTheDwarfExpressionStack.md:3:'myst' cross-reference target not found: 'extens

[Environment information]
llvm-project main branch (8823e961f6a4)
myst-parser version(2.0.0)
</pre>
<img width="1px" height="1px" alt="" src="http://email.email.llvm.org/o/eJzMVkFv2zgT_TX0ZSBBIi3ZOvhg11bzAWm_YtNFjwtKGltsKNJLUk767xekjCh2HKfFpsBeDEt6M3wzfPNIbq3YKcQFyVYkW09471ptFl1kuXA62n6fVLr5sfjaImy1lPpBqB241iDCVki00PIDAhqjjYWHFhXsUKHhzuMaXfcdKsed0Ap669_d7VuhHmOSrEmyHH7TGKQ8dISWja4toeXdHutecicOeKt5c8NNg0qoXdw1QwSNoZZc7caQP1Ait_hZO7SxsW7AsfPMy0_rj1_-XD9ws908OlRWaLX0Zd3qOrBco62N2Pu__1dfWzxC9watx945Xt-_V56ncobfCDa-jdChtXzn-23A-b4LY13o9hHNNkCyFZsRWqZpUpBsDR_HpndcHZt81n-fz3cjajyXpu_2IJTTQCiteiGbsUsdV4TScbVy-b_bzZqwJRwBHz7xeyz9_h-DotPEkSfxC9hxqbqB52SA0JzQHAgte2sILSuhCC3rjt8jRBtAdTj_ZkPtUcgCURX6EZ1mJbT8q9G1M4gXmUd_Q-SGCDTDmzUc0PidI2ydzv2zGRQXnuMkTnbCQeS-GDxKEaJvQ7v3Rn_H2hFaPtPiOZ-TJoz_vnHjhU_oB3AGucMGuB3GjbDliHt9oTfGiS0ZYcvPWkW1Vhbr3qOgRd6gAYkHlCBUbYZKV3CTgtNww7wAux_WxQOSZOufUbLFWqvmkpTnhJZ5kvyKlIMBvFCw01r6ms_sYVD0MyG_gnsp1gAIGnhjiSuhF-V9Kc37y_0VsqP8x_reTfVXK_yJjfoXc_BG9henBFtmRUbYctVLiQ6ksA5QNRYehGt174BDJbm6BylUGIBe4eMea0-gV0I1qNzJWQbXJ8C1wlwYgDQNXn4m_9Z18rqVv2bgPvJU79fNOKx0luMK9HfadaDypl8PqBPBDq9-t0-flv_ORv2fu50MpwOhM-_1hM6gNtrayOAWDaoawXGzQwdKO9jqXvkIIHSGYdXnc0Gy1UYdhNHKqxiE2mrTBS5PZ8fz1kDHhYLKcFW3QOh8PqcMizzd5nxKaDEEeFLRnhuL5mnX6Zz6TSa0mDQL1hSs4BNcpHmRT9PpdJZP2sWM13Ve0VnCE5bNC5ZxhjOWs5wXacpn1UQsaEJZmiTTNEmnLI9Zlm1ZzrM8LabbakrJNMGOCxl7yrE2u4mwtsdFPk-LfCJ5hdKGCzWlCh8gfPQXqmw9MYtQZtXvLJkm3m_smMUJJ3GxCqOw5UL2Bl_cqS_5waQ3ctE6t7dht0pCy51wbV_Fte5GlZ1pL9Dysgu0_wkAAP__nM72vQ">