[Lldb-commits] [lldb] [LLDB][Docs] Fix warnings when building HTML docs (PR #181472)

[via lldb-commits]

Nerixyz wrote:

> Would that still render the same with double backticks?

Yes. In Markdown (at least in GFM and CommonMark), you can use as many backticks as you want as long as the start and end match ([code spans](https://spec.commonmark.org/0.31.2/#code-spans)).

> But even if it does support the RST syntax, I don't think people will expect it, and will keep writing single backticks as Markdown is pretty much the standard. I would much rather fix this at the autodoc/sphinx layer.

I'd also prefer to write Markdown. https://myst-parser.readthedocs.io/en/latest/syntax/code_and_apis.html lists some possible ways to do this. I'll check them out.



https://github.com/llvm/llvm-project/pull/181472