Docstring popup breaks indented code formatting w/o trailing whitespace

[ray-grointel]

Environment data

VS Code version: 1.2.0
Python Extension version: 2018.1
Python Version: 3.6.3
OS and version: macOS 10.12

Actual behavior

If you hover over this function for its docstring popup, if the trailing whitespace represented by .... is missing, the formatting for the indented code breaks.

def fixtures_dir(request):
    """Return the test fixtures directory under `FIXTURES_DIR`.

    Example::

        from conftest import BASE_DIR
........
        def test_something(fixtures_dir):
            assert fixtures_dir.strpath == BASE_DIR + '/some/path'

    :rtype: py.path.LocalPath
    """

Expected behavior

The indented code formatting inside the docstring popup should not change with/without the trailing whitespace.

Steps to reproduce:

• Write the function
• Add/remove the trailing whitespace
• Hover over the function

Logs

Output from Python output panel

N/A

Output from Console window (Help->Developer Tools menu)

N/A

[patrys]

VSCode uses Markdown (as opposed to reStructuredText) so this plugin would need to detect RST comments and translate them. Unfortunately until PEP 287 becomes a standard such assumptions are likely to break comments using other formats.

[patrys]

In case you want to give it a try, the code responsible for handling docstrings is here:

https://github.com/Microsoft/vscode-python/blob/master/src/client/common/markdown/restTextConverter.ts

[DonJayamanne]

@raymond-grointel
Please could you install the insiders build of the extension from here (Insiders Build) and confirm the problem still exists.
Please note, this isn't the insiders build of VS Code.

[MikhailArkhipov]

I believe #725 addressed this