Hi!

Sometimes you have to put docstrings in stub files e.g. when using code
generation. In that case, stubs are the only place you can locate "objects"
to add docstrings to.

Thus it is frustrating to find that docstring-related software generally
tends to ignore the presence of docstrings in stubs or to work incorrectly
with those.

I think we need a PEP to clarify the interaction between stubs and
docstrings. This PEP might also encourage developers of docstring-related
software to mind docstrings provided with stub files.

-- 
Yours sincerely,

Alexey Volobuev
_______________________________________________
Python-ideas mailing list -- python-ideas@python.org
To unsubscribe send an email to python-ideas-le...@python.org
https://mail.python.org/mailman3/lists/python-ideas.python.org/
Message archived at 
https://mail.python.org/archives/list/python-ideas@python.org/message/QKJWPZ6XULFWNRFZYNTXXDC26UVQPFNG/
Code of Conduct: http://python.org/psf/codeofconduct/

Reply via email to