[issue15731] Mechanism for inheriting docstrings and signatures

2016-02-07 Thread Serhiy Storchaka 

Serhiy Storchaka added the comment:

After issue15582, is it still actual?

--

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue15731] Mechanism for inheriting docstrings and signatures

2016-02-07 Thread Nick Coghlan 

Nick Coghlan added the comment:

Agreed, making it easy to follow the inheritance chains at docstring lookup 
time means it would be redundant to duplicate them at class definition time.

Code that interrogates __doc__ directly rather than using inspect.getdoc won't 
benefit from the new behaviour, but that's a quality of implementation question 
in the code handling the introspection.

--
resolution:  -> out of date
stage:  -> resolved
status: open -> closed

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue15731] Mechanism for inheriting docstrings and signatures

2014-01-29 Thread Yury Selivanov 

Changes by Yury Selivanov yselivanov...@gmail.com:


--
nosy: +yselivanov
versions: +Python 3.5 -Python 3.4

___
Python tracker rep...@bugs.python.org
http://bugs.python.org/issue15731
___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue15731] Mechanism for inheriting docstrings and signatures

2014-01-29 Thread Yury Selivanov 

Yury Selivanov added the comment:

Perhaps, something like @functools.inherit decorator could help: 
https://gist.github.com/1st1/8703533 (just a quick illustration).

--

___
Python tracker rep...@bugs.python.org
http://bugs.python.org/issue15731
___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue15731] Mechanism for inheriting docstrings and signatures

2013-01-26 Thread Serhiy Storchaka 

Changes by Serhiy Storchaka storch...@gmail.com:


--
nosy: +serhiy.storchaka

___
Python tracker rep...@bugs.python.org
http://bugs.python.org/issue15731
___
___
Python-bugs-list mailing list
Unsubscribe: 
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue15731] Mechanism for inheriting docstrings and signatures

2012-08-26 Thread Arfrever Frehtes Taifersar Arahesis 

Changes by Arfrever Frehtes Taifersar Arahesis arfrever@gmail.com:


--
nosy: +Arfrever

___
Python tracker rep...@bugs.python.org
http://bugs.python.org/issue15731
___
___
Python-bugs-list mailing list
Unsubscribe: 
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue15731] Mechanism for inheriting docstrings and signatures

2012-08-24 Thread Chris Rebert 

Changes by Chris Rebert pyb...@rebertia.com:


--
nosy: +cvrebert

___
Python tracker rep...@bugs.python.org
http://bugs.python.org/issue15731
___
___
Python-bugs-list mailing list
Unsubscribe: 
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue15731] Mechanism for inheriting docstrings and signatures

2012-08-20 Thread Ben Finney 

Ben Finney added the comment:

Attached is a patch which is more comprehensive (covering the additional 
locations pointed out to me by ncoghlan), and also consolidating the details 
into the library documentation so they're not verbosely repeated in so many 
places.

I agree with Nick's position that the docstrings are not the place to go into 
great detail about the significance and background of the issues. So the 
docstrings in this patch are accurate, but terse; the details are in the 
library documentation.

--
keywords: +patch
nosy: +bignose
Added file: http://bugs.python.org/file26910/issue8810_reconcile_docs.patch

___
Python tracker rep...@bugs.python.org
http://bugs.python.org/issue15731
___
___
Python-bugs-list mailing list
Unsubscribe: 
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue15731] Mechanism for inheriting docstrings and signatures

2012-08-20 Thread Ben Finney 

Ben Finney added the comment:

Apologies, my previous comment and patch was sent to the wrong issue (should 
have gone to #8810).

--

___
Python tracker rep...@bugs.python.org
http://bugs.python.org/issue15731
___
___
Python-bugs-list mailing list
Unsubscribe: 
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue15731] Mechanism for inheriting docstrings and signatures

2012-08-20 Thread Andrew Svetlov 

Changes by Andrew Svetlov andrew.svet...@gmail.com:


--
nosy: +asvetlov

___
Python tracker rep...@bugs.python.org
http://bugs.python.org/issue15731
___
___
Python-bugs-list mailing list
Unsubscribe: 
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue15731] Mechanism for inheriting docstrings and signatures

2012-08-20 Thread Nick Coghlan 

Changes by Nick Coghlan ncogh...@gmail.com:


--
Removed message: http://bugs.python.org/msg168621

___
Python tracker rep...@bugs.python.org
http://bugs.python.org/issue15731
___
___
Python-bugs-list mailing list
Unsubscribe: 
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue15731] Mechanism for inheriting docstrings and signatures

2012-08-20 Thread Nick Coghlan 

Changes by Nick Coghlan ncogh...@gmail.com:


--
Removed message: http://bugs.python.org/msg168622

___
Python tracker rep...@bugs.python.org
http://bugs.python.org/issue15731
___
___
Python-bugs-list mailing list
Unsubscribe: 
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue15731] Mechanism for inheriting docstrings and signatures

2012-08-20 Thread Nick Coghlan 

Changes by Nick Coghlan ncogh...@gmail.com:


Removed file: http://bugs.python.org/file26910/issue8810_reconcile_docs.patch

___
Python tracker rep...@bugs.python.org
http://bugs.python.org/issue15731
___
___
Python-bugs-list mailing list
Unsubscribe: 
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue15731] Mechanism for inheriting docstrings and signatures

2012-08-19 Thread Nick Coghlan 

New submission from Nick Coghlan:

While working on #8810, I was reminded of the problem of wanting to inherit 
docstrings while replacing a method implementation.

The abstract base class method docstrings for tzinfo.utcoffset and tzinfo.dst 
are also correct for the concrete subclasses in the pure Python and the C 
versions. However, the docstrings currently need to be duplicated in all 3 
places manually.

functools.wraps already plays in this space, but arguably asserts *too much* 
about the relationship between components

A couple of descriptors on bound and unbound methods (for __doc__ and 
__signature__) could have dealt with this fairly easily, but we don't have 
unbound methods any more :(

--
components: Library (Lib)
messages: 168618
nosy: eric.snow, ncoghlan
priority: normal
severity: normal
status: open
title: Mechanism for inheriting docstrings and signatures
type: enhancement
versions: Python 3.4

___
Python tracker rep...@bugs.python.org
http://bugs.python.org/issue15731
___
___
Python-bugs-list mailing list
Unsubscribe: 
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue15731] Mechanism for inheriting docstrings and signatures

2012-08-19 Thread Nick Coghlan 

Nick Coghlan added the comment:

Slight correction: turns out this docstring appears in a lot of other places, 
too.

--

___
Python tracker rep...@bugs.python.org
http://bugs.python.org/issue15731
___
___
Python-bugs-list mailing list
Unsubscribe: 
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com