indentation in docstring lists doesn't seem to work

[gkaempfer]

This works:

#. this is the first item
#. this is the second item 

This doesn't work and an error "Enumerated list ends without a blank line; unexpected unindent." is thrown:

#. this is the first item
#. this is the second item with a long
   indented line

I tried all kinds of list formats (numbers, bullets etc) but they all fail in the same way. If the second item in the latter example is separated from the first one with a blank line, it isn't identified as a list item.

[cag]

Like so, right?

#. this is the first item
#. this is the second item with a long
   indented line

By the way, this formatting is accessible by putting a block between a pair of triple-backticks (```)

[gkaempfer]

Fixed my GitHub comment but the issue with sphinx soliditydomain persists :(
I tried using triple-backticks in the Solidity comment but that didn't work either...

[cag]

Hey sorry it's taking so long... I dunno if I have that much bandwidth unfortunately. Also my bad: I had meant that the triple backticks worked on GitHub for preformatted text blocks.

Could you provide some more information about the issue? Is it that you're unable to use rst numbered lists inside of documentation comments, and what does your Sphinx setup look like?

[gkaempfer]

Indeed. I'm using the autodoc feature such as here (rst file):

Solidity Module Name
====================

.. autosolcontract:: SolModule
    :members:

and then have inline comments like this (sol file):

contract SolModule {

    /**
      This function checks validity of a fact.
      It may fail for many reasons:
      #. This is a very very very very very long reason which I would like to break over multiple lines
      #. another reason
      #. last reason

      Maybe a summary
    */
    function isValid(bytes32 fact)
        external view
        returns(bool);
}

If I try to break the first numbered item into two lines I get the error as explained above.
In my conf.py, I'm using:
html_theme = "sphinx_rtd_theme"
extensions = ['sphinx.ext.autodoc', 'sphinxcontrib.soliditydomain'] and some other HTTP domain extensions