id	summary	reporter	owner	description	type	status	component	version	severity	resolution	keywords	cc	stage	has_patch	needs_docs	needs_tests	needs_better_patch	easy	ui_ux
26233	docstring of django.db.models.Q causes warning when building Sphinx docs for my project	Luc Saffre	nobody	"When I write
{{{
from django.db.models import Q
}}}
in my code, then I get a Sphinx warning when building the docs for my project. This is partly due to the fact that Sphinx's autodoc inserts the docstring of Django's Q class into my API doc. But the more obvious problem is that this docstring contains invalid reStructuredText content. The docstring is:

{{{
    Encapsulates filters as objects that can then be combined logically (using
    & and |).
}}}

Correct syntax must be::

{{{
    Encapsulates filters as objects that can then be combined logically (using
    `&` and `|`).
}}}

"	Uncategorized	closed	Documentation	1.9	Normal	fixed			Unreviewed	0	0	0	0	1	0