which is not good. After this PR, they would all appear as one
Fix 2
Secondly, as illustrated in the example above, signatures sometimes get inserted into the doc-string. Previously, we were fixing this by removing them from the html post-build. Unfortunately, if that signature contains (*agrs, **kwargs), bad things happen during the build process since sphinx interprets the *s as special charters. This PR fixes that by providing a means of removing them before Sphinx works its magic.
This PR fixes some issues relating to function names.
Fix 1
Firstly, this PR ensures that all overloads of a function have the same name in the doc. If one were to do
the doc would look something like:
which is not good. After this PR, they would all appear as
one
Fix 2
Secondly, as illustrated in the example above, signatures sometimes get inserted into the doc-string. Previously, we were fixing this by removing them from the html post-build. Unfortunately, if that signature contains
(*agrs, **kwargs)
, bad things happen during the build process since sphinx interprets the*
s as special charters. This PR fixes that by providing a means of removing them before Sphinx works its magic.