As Jon previously noted [1], it would be nice if automarkup supported relative paths as well when cross-referencing to other documents. This adds the support for it, and documents it. Jon, after applying this, 43bc3ed73639 ("docs: dt: Use full path to enable cross-reference") could be reverted without the link stopping to work. [1] https://lore.kernel.org/linux-doc/20201130142404.6ef6689e@xxxxxxx/ Nícolas F. R. A. Prado (2): docs: Enable usage of relative paths to docs on automarkup docs: Document cross-referencing using relative path Documentation/doc-guide/sphinx.rst | 30 ++++++++++++++++++++---------- Documentation/sphinx/automarkup.py | 7 +++++-- 2 files changed, 25 insertions(+), 12 deletions(-) -- 2.30.0