[issue12916] Add inspect.splitdoc

[Yury Selivanov]

Yury Selivanov added the comment:

David:

> The precedent has already been set by the 'cleandoc' function, I think.  This one seems to go right along with that one.

What do you think if we keep the function in pydoc module, but document it and make it public?  I agree, that there is a precedent of having non-introspection APIs in inspect, but I'd still like to keep it minimal.  Having this function in pydoc also makes sense, as it's more about python docstring convention, than introspection (cleandoc() is used by getdoc(), which is why it is in inspect after all)

----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue12916>
_______________________________________