Skip to content

Commit 4935023

Browse files
committed
Revert "Intersphinx lookups: add origin-hyperlink to log warnings about ambiguous target resolution."
This reverts commit 72b266d.
1 parent 72b266d commit 4935023

File tree

1 file changed

+15
-28
lines changed

1 file changed

+15
-28
lines changed

sphinx/ext/intersphinx/_resolve.py

Lines changed: 15 additions & 28 deletions
Original file line numberDiff line numberDiff line change
@@ -64,9 +64,7 @@ def _resolve_reference_in_domain_by_target(
6464
inv_name: str | None, inventory: Inventory,
6565
domain: Domain, objtypes: Iterable[str],
6666
target: str,
67-
node: pending_xref, contnode: TextElement,
68-
app: Sphinx | None = None
69-
) -> nodes.reference | None:
67+
node: pending_xref, contnode: TextElement) -> nodes.reference | None:
7068
for objtype in objtypes:
7169
if objtype not in inventory:
7270
# Continue if there's nothing of this kind in the inventory
@@ -83,13 +81,8 @@ def _resolve_reference_in_domain_by_target(
8381
insensitive_matches = list(filter(lambda k: k.lower() == target_lower,
8482
inventory[objtype].keys()))
8583
if len(insensitive_matches) > 1:
86-
inventory_location = (
87-
app.config.intersphinx_mapping[inv_name][1][0]
88-
if (inv_name and app and inv_name in app.config.intersphinx_mapping) else
89-
"./objects.inv"
90-
)
91-
LOGGER.warning(__("multiple matches found for %s:%s in <%s>"),
92-
objtype, target, inventory_location,
84+
LOGGER.warning(__("multiple matches found for %s:%s"),
85+
objtype, target,
9386
type='intersphinx', subtype='external', location=node)
9487
if insensitive_matches:
9588
data = inventory[objtype][insensitive_matches[0]]
@@ -110,7 +103,6 @@ def _resolve_reference_in_domain(env: BuildEnvironment,
110103
honor_disabled_refs: bool,
111104
domain: Domain, objtypes: Iterable[str],
112105
node: pending_xref, contnode: TextElement,
113-
app: Sphinx | None = None,
114106
) -> nodes.reference | None:
115107
obj_types: dict[str, None] = {}.fromkeys(objtypes)
116108

@@ -137,7 +129,7 @@ def _resolve_reference_in_domain(env: BuildEnvironment,
137129

138130
# without qualification
139131
res = _resolve_reference_in_domain_by_target(inv_name, inventory, domain, objtypes,
140-
node['reftarget'], node, contnode, app)
132+
node['reftarget'], node, contnode)
141133
if res is not None:
142134
return res
143135

@@ -146,14 +138,12 @@ def _resolve_reference_in_domain(env: BuildEnvironment,
146138
if full_qualified_name is None:
147139
return None
148140
return _resolve_reference_in_domain_by_target(inv_name, inventory, domain, objtypes,
149-
full_qualified_name, node, contnode, app)
141+
full_qualified_name, node, contnode)
150142

151143

152144
def _resolve_reference(env: BuildEnvironment, inv_name: str | None, inventory: Inventory,
153145
honor_disabled_refs: bool,
154-
node: pending_xref, contnode: TextElement,
155-
app: Sphinx | None = None
156-
) -> nodes.reference | None:
146+
node: pending_xref, contnode: TextElement) -> nodes.reference | None:
157147
# disabling should only be done if no inventory is given
158148
honor_disabled_refs = honor_disabled_refs and inv_name is None
159149

@@ -170,7 +160,7 @@ def _resolve_reference(env: BuildEnvironment, inv_name: str | None, inventory: I
170160
res = _resolve_reference_in_domain(env, inv_name, inventory,
171161
honor_disabled_refs,
172162
domain, objtypes,
173-
node, contnode, app)
163+
node, contnode)
174164
if res is not None:
175165
return res
176166
return None
@@ -189,7 +179,7 @@ def _resolve_reference(env: BuildEnvironment, inv_name: str | None, inventory: I
189179
return _resolve_reference_in_domain(env, inv_name, inventory,
190180
honor_disabled_refs,
191181
domain, objtypes,
192-
node, contnode, app)
182+
node, contnode)
193183

194184

195185
def inventory_exists(env: BuildEnvironment, inv_name: str) -> bool:
@@ -199,7 +189,6 @@ def inventory_exists(env: BuildEnvironment, inv_name: str) -> bool:
199189
def resolve_reference_in_inventory(env: BuildEnvironment,
200190
inv_name: str,
201191
node: pending_xref, contnode: TextElement,
202-
app: Sphinx | None = None,
203192
) -> nodes.reference | None:
204193
"""Attempt to resolve a missing reference via intersphinx references.
205194
@@ -209,26 +198,24 @@ def resolve_reference_in_inventory(env: BuildEnvironment,
209198
"""
210199
assert inventory_exists(env, inv_name)
211200
return _resolve_reference(env, inv_name, InventoryAdapter(env).named_inventory[inv_name],
212-
False, node, contnode, app)
201+
False, node, contnode)
213202

214203

215204
def resolve_reference_any_inventory(env: BuildEnvironment,
216205
honor_disabled_refs: bool,
217206
node: pending_xref, contnode: TextElement,
218-
app: Sphinx | None = None,
219207
) -> nodes.reference | None:
220208
"""Attempt to resolve a missing reference via intersphinx references.
221209
222210
Resolution is tried with the target as is in any inventory.
223211
"""
224212
return _resolve_reference(env, None, InventoryAdapter(env).main_inventory,
225213
honor_disabled_refs,
226-
node, contnode, app)
214+
node, contnode)
227215

228216

229217
def resolve_reference_detect_inventory(env: BuildEnvironment,
230218
node: pending_xref, contnode: TextElement,
231-
app: Sphinx | None = None
232219
) -> nodes.reference | None:
233220
"""Attempt to resolve a missing reference via intersphinx references.
234221
@@ -238,7 +225,7 @@ def resolve_reference_detect_inventory(env: BuildEnvironment,
238225
is tried in that inventory with the new target.
239226
"""
240227
# ordinary direct lookup, use data as is
241-
res = resolve_reference_any_inventory(env, True, node, contnode, app)
228+
res = resolve_reference_any_inventory(env, True, node, contnode)
242229
if res is not None:
243230
return res
244231

@@ -250,15 +237,15 @@ def resolve_reference_detect_inventory(env: BuildEnvironment,
250237
if not inventory_exists(env, inv_name):
251238
return None
252239
node['reftarget'] = newtarget
253-
res_inv = resolve_reference_in_inventory(env, inv_name, node, contnode, app)
240+
res_inv = resolve_reference_in_inventory(env, inv_name, node, contnode)
254241
node['reftarget'] = target
255242
return res_inv
256243

257244

258245
def missing_reference(app: Sphinx, env: BuildEnvironment, node: pending_xref,
259246
contnode: TextElement) -> nodes.reference | None:
260247
"""Attempt to resolve a missing reference via intersphinx references."""
261-
return resolve_reference_detect_inventory(env, node, contnode, app)
248+
return resolve_reference_detect_inventory(env, node, contnode)
262249

263250

264251
class IntersphinxDispatcher(CustomReSTDispatcher):
@@ -497,9 +484,9 @@ def run(self, **kwargs: Any) -> None:
497484
inv_name = node['inventory']
498485
if inv_name is not None:
499486
assert inventory_exists(self.env, inv_name)
500-
newnode = resolve_reference_in_inventory(self.env, inv_name, node, contnode, self.app)
487+
newnode = resolve_reference_in_inventory(self.env, inv_name, node, contnode)
501488
else:
502-
newnode = resolve_reference_any_inventory(self.env, False, node, contnode, self.app)
489+
newnode = resolve_reference_any_inventory(self.env, False, node, contnode)
503490
if newnode is None:
504491
typ = node['reftype']
505492
msg = (__('external %s:%s reference target not found: %s') %

0 commit comments

Comments
 (0)