homepage

This issue tracker has been migrated to GitHub , and is currently read-only.
For more information, see the GitHub FAQs in the Python's Developer Guide.

classification
Title: Allow to override a function signature for pydoc with a docstring
Type: enhancement Stage: needs patch
Components: Interpreter Core Versions:
process
Status: open Resolution:
Dependencies: Superseder:
Assigned To: Nosy List: eric.araujo, georg.brandl, meador.inge, serhiy.storchaka
Priority: normal Keywords:

Created on 2013年01月02日 20:08 by serhiy.storchaka, last changed 2022年04月11日 14:57 by admin.

Messages (4)
msg178846 - (view) Author: Serhiy Storchaka (serhiy.storchaka) * (Python committer) Date: 2013年01月02日 20:08
Just a quote of Georg Brandl's msg178519:
> A simple, minimal-invasive solution would be to allow a signature for documentation purposes as the first line of the docstrings.
>
> pydoc could recognize this (if docstring.startswith(func.__name__ + '(') or something like that), and display the given signature instead of the introspected one.
I see only one obstacle. Some functions (like dict.update()) needs several signatures. How detect and format them?
msg178880 - (view) Author: Meador Inge (meador.inge) * (Python committer) Date: 2013年01月03日 01:35
Serhiy, did you mean to mark this as "patch review"? I don't see a patch.
msg178930 - (view) Author: Serhiy Storchaka (serhiy.storchaka) * (Python committer) Date: 2013年01月03日 10:08
Sorry, I mixed up the issues. For this issue I have not a patch yet. I wait for some suggestions and decisions first.
See also related issue16638.
msg396727 - (view) Author: Éric Araujo (eric.araujo) * (Python committer) Date: 2021年06月29日 13:47
This proposal pre-dates signature objects; I wonder if they can be used to handle the use cases here.
History
Date User Action Args
2022年04月11日 14:57:40adminsetgithub: 61046
2021年06月29日 13:47:58eric.araujosetmessages: + msg396727
versions: - Python 3.4
2013年01月08日 12:27:12eric.araujosetnosy: + eric.araujo
2013年01月03日 10:08:59serhiy.storchakasetmessages: + msg178930
stage: patch review -> needs patch
2013年01月03日 01:35:51meador.ingesetnosy: + meador.inge
messages: + msg178880
2013年01月02日 21:59:39serhiy.storchakasetstage: needs patch -> patch review
2013年01月02日 20:08:25serhiy.storchakacreate

AltStyle によって変換されたページ (->オリジナル) /