'Emit a warning.
This differs from using ``app.warn()`` in that the warning may not
be emitted instantly, but collected for emitting all warnings after
the update of the environment.'

def warn(self, docname, msg, lineno=None, **kwargs):

    self.app.warn(msg, location=(docname, lineno), **kwargs)
