[llvm-dev] Question for Sphinx experts

[Paul C. Anagnostopoulos via llvm-dev]

The file has a '.. program:: tblgen' at the top. I think the issue is that there are two identical '.. option' names in the same file. Apparently each option generates a target name, two of which are the same.

Does anyone know where to find the documentation on the '.. option' directive? I just exceeded by 10-minute limit on searching the interwebs.

At 1/26/2021 03:24 AM, James Henderson wrote:
>I think you need to scope the doc - there are similar issues in various of the LLVM binutils tools. For example, both the llvm-readelf and llvm-objdump docs describe the `--file-headers` options. The scoping you need (I think) is the line at the top of these docs that looks something like `.. program:: llvm-objdump`. Indeed, without that scoping, you can potentially end up with docs linking to options described on other pages, which is almost certainly not what you want.