Impossible to combine ~ and ! in a cross-reference

[parulin]

Describe the bug

You can't combine ~ and ! in a cross-reference

How to Reproduce

:py:func:`!~any.thing`

Will output ~any.thing()

:py:func:`~!any.thing`

Will output thing(), the expected behavior but a warning is raised

Environment Information

Platform:              linux; (Linux-6.18.35-1.qubes.fc41.x86_64-x86_64-with-glibc2.41)
Python version:        3.13.5 (main, Jun 13 2026, 14:18:01) [GCC 14.2.0])
Python implementation: CPython
Sphinx version:        9.1.0
Docutils version:      0.22.4
Jinja2 version:        3.1.6
Pygments version:      2.20.0

Sphinx extensions

none

Additional context

[parulin]

The first version of this issue was wrong because I haven't checked the logs. This is useful to mark some functions in the docs, and document them properly later. But it could also be acceptable to just document that it is impossible to combine them.

[jdillard]

I made a simple docs PR if you have any feedback to give: #14582

It seems supporting combining ! and ~ should be possible in the future, it would just take some work (that likely wouldn't be done soon).

[Viicos]

I believe this is a duplicate of #13865.

[parulin]

#14582 is still a good idea in the meantime

[jdillard]

Nice catch, #13865 contains the fuller reproducer and existing discussion, so I’m closing this issue in favor of that one.