docstring: Regarding Korean line spacing problem

[swdev-j]

Environment data

• Language Server version: v2023.7.21
• OS and version: windows 11
• Python version (& distribution if applicable, e.g. Anaconda): 3.9.12

Code Snippet

# -*- coding: utf-8 -*-

def fun(a:int, b:int, c:int):
    """_summary_
    test
    
    Args:
        a (int): _description_
        b (int): 한국어
        c (int): _description_
    """

print(fun.__doc__)

Repro Steps

1. write and standard docstring that contains parenthesis and then hover over the function to observe the formatting of the docstring.
2. compare this to the expected formatting given by print(my_function.doc).

Expected behavior

I believe this will output something like below.

Actual behavior

But, I hover over the function, it does not same output.
It should show the same result as print.

[heejaechang]

looks like our regex for doc string doesn't work properly with Korean. (or any other language except English)

[heejaechang]

tagging @Bill ?

[rchiodo]

This issue has been fixed in prerelease version 2024.6.100, which we've just released. You can find the changelog here: CHANGELOG.md

[rchiodo]

The fix for this issue is behind an experimental feature flag:

"python.analysis.supportRestructuredText": true

If you want to try out our new restructuredText support, enable this flag. It's behind a flag at the moment until we can make sure it handles all the possible Sphinx/GoogleDoc/Epytext scenarios that customers need. Please log additional issues if this setting isn't working out for you.

Thanks :)