Sphinx :ivar tag goes looking for cross-references

Question

I want to document Python object attributes with Sphinx. I understand I should use

:ivar varname: description
:ivar type varname: description

Answer 1

Here is a workaround provided by @acrisci on github: prefix your variable name with ~.. For example replace

:ivar float bandwidth: blah

with this:

:ivar float ~.bandwidth: blah

Source: https://github.com/sphinx-doc/sphinx/issues/2549#issuecomment-488896939