Allow inline links in Google style docstrings

[picnixz]

Fix #11246

Detail

• Inline links are now allowed in the first line of a docstring when sphinx.ext.napoleon is active.

Discussion

In order to allow arbitrary colons that are not meant to separate the documented member type from its description, escaping : could be considered (but the parser would require a more careful analysis).

Related

• Using a colon in the property's description, treats the leading text as return type #9273

[picnixz]

After investigation, I also needed to add some escape mechanism for :meta [...]: since otherwise, we cannot simply write :meta public:. I also took into consideration a future :meta field: value syntax (that I implemented for my own extension).

[AA-Turner]

Please may you add an entry to CHANGES?

[picnixz]

Thank you !