Require \ for asterisks in Sphinx-style parameter docstrings

[DanielNoord]

• Add yourself to CONTRIBUTORS if you are a new contributor.
• Add a ChangeLog entry describing what your PR does.
• If it's a new feature, or an important bug fix, add a What's New entry in
  doc/whatsnew/<current release.rst>.
• Write a good description on what the PR does.

Type of Changes

	Type
✓	🐛 Bug fix

Description

Closes #5406

This took way longer than it should have.. Never do regex on a Friday..

[coveralls]

Pull Request Test Coverage Report for Build 1535712912

• 1 of 1 (100.0%) changed or added relevant line in 1 file are covered.
• No unchanged relevant lines lost coverage.
• Overall coverage increased (+0.0004%) to 93.532%

---

Totals
Change from base Build 1535710960:	0.0004%
Covered Lines:	14026
Relevant Lines:	14996

---

💛 - Coveralls

[Pierre-Sassoulas]

Never do regex on a Friday..

s/' on a Friday.'/''/g 😄

[Pierre-Sassoulas]

I was joking about regex, I like them fondly. But the approach with regex might have been an original design mistake. Good job managing with that though. The fix is quite dandy, Also the more tests we have the more manageable a migration from regex in the future will be if hard to fix bugs keep piling up. Chances are most case are handled and we won't have to change this too often.

[DanielNoord]

I was joking about regex, I like them fondly. But the approach with regex might have been an original design mistake. Good job managing with that though. The fix is quite dandy, Also the more tests we have the more manageable a migration from regex in the future will be if hard to fix bugs keep piling up. Chances are most case are handled and we won't have to change this too often.

I do to, but what is really annoying is how these patterns are written. It doesn't allow you to easily copy them over to regex101.com or a similar engine. That has really frustrated my process of working on these..