What is the cause of the Sphinx warning "Block quote ends without a blank line; unexpected unindent" in a one line docstring

Question

When I build my Sphinx HTML documentation, I get a warning.

checkdmarc.py:docstring of checkdmarc.BIMIRecordInWrongLocation:1: WARNING: Block quote ends without a blank line; unexpected unindent.

BIMIRecordInWrongLocation is a simple Exception class with a one line docstring.

class BIMIRecordInWrongLocation(BIMIError):
    """Raised when a BIMI record is found at the root of a domain"""

Oddly, the warning persisted even after I replaced the docstring with pass.

For context, here is the full code, and the Sphinx build log.

Answer 1

I had the same issue, but it was because I had a new line character in the docstring. I removed it and it worked.