docs: only link to old docs from html
authorErik Faye-Lund <erik.faye-lund@collabora.com>
Fri, 6 Oct 2023 09:29:46 +0000 (11:29 +0200)
committerMarge Bot <emma+marge@anholt.net>
Mon, 9 Oct 2023 11:54:12 +0000 (11:54 +0000)
Only the HTML builder knows about these files, so we can't really link
to them when using other builders. This only matter to the link-checker
right now, because that's the only other builder we use.

It's a bit sad that we can't linkcheck files like these, but it doesn't
work either way. Another way of making it work could be to use the
download-role for these files. I'm not sure I think that's any better,
as that makes the code read a bit more confusingly to me; the intent
isn't to *download* the files, but to view them as raw-text.

I could go either way here, though. Neither is fantastic IMO, but
neither is a disaster either.

Reviewed-by: Corentin Noël <corentin.noel@collabora.com>
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/25585>

docs/relnotes.rst

index 03363c6..3c77239 100644 (file)
@@ -367,34 +367,36 @@ The release notes summarize what's new or changed in each Mesa release.
 -  :doc:`6.4.1 release notes <relnotes/6.4.1>`
 -  :doc:`6.4 release notes <relnotes/6.4>`
 
-Versions of Mesa prior to 6.4 are summarized in the following
-release notes, or in the `old docs`_.
+.. only:: builder_html
 
--  `6.3.2 release notes <relnotes/6.3.2>`__
--  `6.3.1 release notes <relnotes/6.3.1>`__
--  `6.3 release notes <relnotes/6.3>`__
--  `6.2.1 release notes <relnotes/6.2.1>`__
--  `6.2 release notes <relnotes/6.2>`__
--  `6.1 release notes <relnotes/6.1>`__
--  `6.0.1 release notes <relnotes/6.0.1>`__
--  `6.0 release notes <relnotes/6.0>`__
--  `5.1 release notes <relnotes/5.1>`__
--  `5.0.2 release notes <relnotes/5.0.2>`__
--  `5.0.1 release notes <relnotes/5.0.1>`__
--  `5.0 release notes <relnotes/5.0>`__
--  `4.1 release notes <relnotes/4.1>`__
--  `4.0.3 release notes <relnotes/4.0.3>`__
--  `4.0.2 release notes <relnotes/4.0.2>`__
--  `4.0.1 release notes <relnotes/4.0.1>`__
--  `4.0 release notes <relnotes/4.0>`__
--  `3.5 release notes <relnotes/3.5>`__
--  `3.4.2 release notes <relnotes/3.4.2>`__
--  `3.4.1 release notes <relnotes/3.4.1>`__
--  `3.4 release notes <relnotes/3.4>`__
--  `3.3 release notes <relnotes/3.3>`__
--  `3.2.1 release notes <relnotes/3.2.1>`__
--  `3.2 release notes <relnotes/3.2>`__
--  `3.1 release notes <relnotes/3.1>`__
+   Versions of Mesa prior to 6.4 are summarized in the following
+   release notes, or in the `old docs`_.
+
+   -  `6.3.2 release notes <relnotes/6.3.2>`__
+   -  `6.3.1 release notes <relnotes/6.3.1>`__
+   -  `6.3 release notes <relnotes/6.3>`__
+   -  `6.2.1 release notes <relnotes/6.2.1>`__
+   -  `6.2 release notes <relnotes/6.2>`__
+   -  `6.1 release notes <relnotes/6.1>`__
+   -  `6.0.1 release notes <relnotes/6.0.1>`__
+   -  `6.0 release notes <relnotes/6.0>`__
+   -  `5.1 release notes <relnotes/5.1>`__
+   -  `5.0.2 release notes <relnotes/5.0.2>`__
+   -  `5.0.1 release notes <relnotes/5.0.1>`__
+   -  `5.0 release notes <relnotes/5.0>`__
+   -  `4.1 release notes <relnotes/4.1>`__
+   -  `4.0.3 release notes <relnotes/4.0.3>`__
+   -  `4.0.2 release notes <relnotes/4.0.2>`__
+   -  `4.0.1 release notes <relnotes/4.0.1>`__
+   -  `4.0 release notes <relnotes/4.0>`__
+   -  `3.5 release notes <relnotes/3.5>`__
+   -  `3.4.2 release notes <relnotes/3.4.2>`__
+   -  `3.4.1 release notes <relnotes/3.4.1>`__
+   -  `3.4 release notes <relnotes/3.4>`__
+   -  `3.3 release notes <relnotes/3.3>`__
+   -  `3.2.1 release notes <relnotes/3.2.1>`__
+   -  `3.2 release notes <relnotes/3.2>`__
+   -  `3.1 release notes <relnotes/3.1>`__
 
 .. toctree::
    :maxdepth: 1