<div dir="ltr"><div dir="ltr">Am Fr., 14. Aug. 2020 um 11:24 Uhr schrieb Paul C. Anagnostopoulos via llvm-dev <<a href="mailto:llvm-dev@lists.llvm.org">llvm-dev@lists.llvm.org</a>>:</div><div class="gmail_quote"><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex">
:doc:`Title <TableGen/ProgRef>`<br></blockquote><div><br></div><div>A link to another document with a path relative to the current document. Title is the <a href="...">caption</a> of the link.</div><div><br></div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex">
<br>
:doc:`../CodeGenerator`<br></blockquote><div><br></div><div><div><br></div><div>A link to another document with a path relative to the current document. The linked document's title is used for the caption.</div></div><div> </div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex">
<br>
`Title <<a href="https://clang.llvm.org/docs/.." rel="noreferrer" target="_blank">https://clang.llvm.org/docs/..</a>.>`_<br></blockquote><div><br></div><div>A link to an arbitrary URL. Please avoid for cross-references as it should change relative to where the documents are. For instance, each the documentation of each release should link to the version of its release (e.g. <a href="https://releases.llvm.org/10.0.0/tools/clang/docs/index.html">https://releases.llvm.org/10.0.0/tools/clang/docs/index.html</a>), not the latest from trunk (e.g. <a href="https://clang.llvm.org/docs/index.html">https://clang.llvm.org/docs/index.html</a>)</div><div><br></div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex">
<br>
I had no luck searching online. If it matters, I'm adding cross-references between TableGen documents that are all in the same docs/ TableGen directory.<br></blockquote><div><br></div><div>reStructured Text documentation is available at: </div><div><br></div><div><a href="https://www.sphinx-doc.org/en/master/usage/restructuredtext/basics.html#hyperlinks">https://www.sphinx-doc.org/en/master/usage/restructuredtext/basics.html#hyperlinks</a><br></div><div><a href="https://www.sphinx-doc.org/en/master/usage/restructuredtext/roles.html#role-doc">https://www.sphinx-doc.org/en/master/usage/restructuredtext/roles.html#role-doc</a>.</div><div><br></div><div>The :ref: role is useful as well.</div><div><br></div><div><br></div><div>Michael</div><div> </div></div></div>