On Tue, Dec 22, 2020 at 08:07:25PM +0300, Alexey Volobuev wrote:
> 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.

It is not clear to me whether you are talking about dynamic tools that 
operate on the objects themselves, like `help()` and `inspect.getdoc()`, 
or static analysis tools that are expecting to work with source code.

Can you elaborate on the nature of the problem and your recommended 
solution?


-- 
Steve
_______________________________________________
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/PQEA2CAHBFJPKANM5IQHKNCEOLISFTPF/
Code of Conduct: http://python.org/psf/codeofconduct/

Reply via email to