confusing error "Missing a blank line before epytext markups"

[Jean-Paul Calderone]

This error is reported:

    W9207:927,4:FilePath.getInodeNumber: Missing a blank line before epytext markups

when getInodeNumber looks like this:

    def getInodeNumber(self):
        """
        Retrieve the file serial number, also called inode number, which
        distinguishes this file from all other files on the same device.

        @raise NotImplementedError: if the platform is Windows, since the
            inode number would be a dummy value for all files in Windows
        @return: a number representing the file serial number
        @rtype: L{int}
        @since: 11.0
        """

It's not really clear what the problem with this docstring is.

[wsanchez (wsanchez)]

In checkers.docstring._checkBlankLineBeforeEpytext, patternEpytext is missing cvar and ivar. Of, for the above example, raise.

Here's my code that also fails here:

    @cvar defaultLogger: The default L{Logger} instance to use when none is
        supplied to L{LoggingFile.__init__}.
    @type defaultLogger: L{Logger}