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

    <tr>
        <th>Summary</th>
        <td>
            [clang][docs] Building the docs-clang-man target fails
        </td>
    </tr>

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

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

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

<pre>
    Currently I'm unable to get the `docs-clang-man` target to build. It fails with following error:
```
[1874/3528] Generating man Sphinx documentation for clang into "/llvm-project/build/tools/clang/docs/man"
FAILED: tools/clang/docs/CMakeFiles/docs-clang-man /llvm-project/build/tools/clang/docs/CMakeFiles/docs-clang-man 
cd /llvm-project/build/tools/clang/docs && /usr/bin/cmake -E env /usr/bin/sphinx-build -b man -d /llvm-project/build/tools/clang/docs/_doctrees-clang-man -q -t builder-man -D version=16 -D release=16.0.3 -W /llvm-project/clang/docs /llvm-project/build/tools/clang/docs/man
/usr/lib/python3/dist-packages/recommonmark/parser.py:75: UserWarning: Container node skipped: type=document
  warn("Container node skipped: type={0}".format(mdnode.t))

Warning, treated as error:
/llvm-project/clang/docs/index.rst:16:toctree contains reference to nonexisting document 'ClangCommandLineReference'
[1907/3528] Generating html Sphinx documentation for clang into "/llvm-project/build/tools/clang/docs/html"
/usr/lib/python3/dist-packages/recommonmark/parser.py:75: UserWarning: Container node skipped: type=document
  warn("Container node skipped: type={0}".format(mdnode.t))
ninja: build stopped: subcommand failed.
```

Using Ubuntu 22.04 provided `sphinx` (`4.3.2`), and recommonmark (`0.6.0`).

The HTML target builds just fine (`docs-clang-html`).

Building the specific target for the missing file (`gen-ClangCommandLineReference.rst`) works just fine and it ends up getting put in `<build dir>/tools/clang/docs/ClangCommandLineReference.rst`, but I don't believe `sphinx-build` is picking up the right folder.
</pre>
<img width="1px" height="1px" alt="" src="http://email.email.llvm.org/o/eJzcVl1vozgX_jUnN0cgMAGSi1ykyfC-lWZudqeay5XBh-DG2Kxt-vHvVzbNttPpdNSV9mYlhGQ4H89zPs2dkydNtIPyCsrjis9-MHbXGjNyzaUgnZfrVWvE4-4wW0vaq0e8BlaPOGveKkJv8EQe_UAIVSZM55JOcX1KRq6hytBzG_8bbGepRIrXHnsulcN76QfsjVLmXuoTkrXGQrGH7AjZHqrs6VmO5VW-qdfAmqJkGyiP-D_SZLkPmiPX-Ps0SP2AwnTzSNpzL43G3liMYFBqbxAYA9YodTcmkzW31HlgTUQFrPHGKAesifLAmsAEWBNYMLaAaPbXnz8dodjjT4QPX_iZGqnIPX17DgV-2PO7xiKeTnzQKgKrgFVBa3Y2CEsdREZ-Jkw-Iem71_9cjGsSrWLSxlgnH_ULrPlDmM5bopcskj8x8UtZkF2-HPGOrJNGQ3HMq3C2pIg7iuc0SwtMvr3h_RXLf5Dkpcwu5JVsgTXTox-MLoKgdD6ZeHfmp5gPS50ZR6NHbs9BkFtHNp0eodjXZaiQG0f2G7da6lM4Hoz2XGqyqI0gdGc5TSRiKT1OgdylcBcciPfcamAbYOyXqlBfZVAfgbG0N3bkHthmFEE49cC24VnIxfcFFDugt8Q9CeTudfO9G19gjdSCHlLrPBT7vIJi75fsYreAdWipJ0u6iwNCG00P0sVmvRBFYPUhWD2YceRafJaafrsoAauf-36b1W_3_eBH9a81fjD-d-f_p-tCS33Lg97S5M6biyE3t92SnTiySaRvD-f4vnEhJzftrP2MjKXZGidr7qQgETbDMkjCRgjwq2ydFikLJgKSAwYfL4P3JJWlVZotUulLZ18Hwv9__fL5sl4idIe3s_PYS01P6i_GZsznj4augmIAHhaYm6iTvewuVkMZhe-jdJFcL9XF8ol08tPyjZ0RfeG9seeXuAJP6ZG0cDhPYXXGUp5mj1KHOEFxWPIgpIXi0zv74ZfeD9jOHq9RGA2s9tiSknRHz9lYxnrIiXQ4ye4coMxT5GzlaQgRCLM5XYldIbbFlq9ol1ebIq9YtS1Ww67d1Lxgm7yvu5bl_bbredfXVSvqul5XNV_JHctYkZXZOsvzvCjSgvpc9DWJkpc8YxzWGY1cqjS0Z2rsaSWdm2lXsXKdrRRvSbl4O2FsCUCx_67XQ4-Wx5XdxfZu55ODdaak8-7ZopdexSvOYqE8QnkVo1ge8bsCeLVmL2UQriur2ard4P3kwphkDbDmJP0wt2lnxqfp8uOQiVxCtiKdvwIAAP__wXwNfA">