From 1580f5f7fda2f741c8052fca7239948612bf4463 Mon Sep 17 00:00:00 2001 From: Victor Wheeler Date: Sun, 8 Jun 2025 13:41:45 -0600 Subject: [PATCH] Note that the ``:doc:`` role is case-sensitive (#13587) --- doc/usage/referencing.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/doc/usage/referencing.rst b/doc/usage/referencing.rst index 2597c9ce59..571d3c798b 100644 --- a/doc/usage/referencing.rst +++ b/doc/usage/referencing.rst @@ -136,8 +136,8 @@ There is also a way to directly link to documents: .. rst:role:: doc - Link to the specified document; the document name can be specified in - absolute or relative fashion. For example, if the reference + Link to the specified document; the document name can be a relative or absolute + path and is always case-sensitive, even on Windows. For example, if the reference ``:doc:`parrot``` occurs in the document ``sketches/index``, then the link refers to ``sketches/parrot``. If the reference is ``:doc:`/people``` or ``:doc:`../people```, the link refers to ``people``.