From 46a37d21ccc45464556360450a3ff492362f0c72 Mon Sep 17 00:00:00 2001
From: Robert <robert.soor@gmail.com>
Date: Sat, 7 Mar 2026 13:13:58 +0100
Subject: [PATCH 1/2] Added try-catch for autodoc mock-import

---
 sphinxarg/ext.py | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/sphinxarg/ext.py b/sphinxarg/ext.py
index 847a187..f796b17 100644
--- a/sphinxarg/ext.py
+++ b/sphinxarg/ext.py
@@ -14,12 +14,17 @@
 from docutils.statemachine import StringList
 from sphinx.domains import Domain, Index, IndexEntry
 from sphinx.errors import ExtensionError
-from sphinx.ext.autodoc import mock
 from sphinx.roles import XRefRole
 from sphinx.util import logging
 from sphinx.util.docutils import SphinxDirective, new_document
 from sphinx.util.nodes import make_id, make_refnode, nested_parse_with_titles
 
+try:
+    from sphinx.ext.autodoc.mock import mock
+except ImportError:
+    from sphinx.ext.autodoc import mock
+    # A persistent bug in sphinx / autodoc causes problems during importing (#82)
+
 from sphinxarg import __version__
 from sphinxarg.parser import parse_parser, parser_navigate
 from sphinxarg.utils import command_pos_args, target_to_anchor_id

From 4e8f1c44fe2904d0454fcf1acba46dbdb4abfdd8 Mon Sep 17 00:00:00 2001
From: Robert Roos <robert.soor@gmail.com>
Date: Thu, 25 Jun 2026 08:41:28 +0200
Subject: [PATCH 2/2] Dropped Sphinx upper version limit

---
 pyproject.toml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/pyproject.toml b/pyproject.toml
index e2f411e..bf368bd 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -36,7 +36,7 @@ classifiers = [
     "Topic :: Documentation :: Sphinx",
 ]
 dependencies = [
-    "sphinx>=5.1.0,<9.0.0",
+    "sphinx>=5.1.0",
     "docutils>=0.19",  # for get_default_settings()
 ]
 dynamic = ["version"]