Re: how to inherit docstrings?

Path	csiph.com!x330-a1.tempe.blueboxinc.net!usenet.pasdenom.info!selfless.tophat.at!newsfeed.xs4all.nl!newsfeed5.news.xs4all.nl!xs4all!post.news.xs4all.nl!not-for-mail
Return-Path	<python-python-list@m.gmane.org>
X-Original-To	python-list@python.org
Delivered-To	python-list@mail.python.org
X-Spam-Status	OK 0.001
X-Spam-Evidence	'H': 1.00; 'S': 0.00; 'terry': 0.07; 'received:80.91': 0.09; 'received:80.91.229': 0.09; 'received:80.91.229.12': 0.09; 'received:gmane.org': 0.09; 'received:list': 0.09; 'received:lo.gmane.org': 0.09; 'subclass': 0.09; 'pm,': 0.10; ';-)': 0.14; 'wrote:': 0.14; 'docstring': 0.16; 'inherited': 0.16; 'inheriting': 0.16; 'presumably,': 0.16; 'reedy': 0.16; 'language': 0.18; 'jan': 0.20; 'header:In-Reply- To:1': 0.21; 'interpreted': 0.23; 'expect': 0.25; 'not.': 0.26; 'otherwise.': 0.29; 'subject:how': 0.29; 'subject:?': 0.29; 'explicitly': 0.29; 'carl': 0.30; 'useless': 0.30; 'header:X -Complaints-To:1': 0.32; 'to:addr:python-list': 0.33; 'however,': 0.34; 'header:User-Agent:1': 0.35; 'change': 0.37; 'received:org': 0.38; 'could': 0.38; 'subject:: ': 0.38; "i'd": 0.39; 'empty': 0.39; 'header:Mime-Version:1': 0.39; 'to:addr:python.org': 0.39; 'help': 0.40; 'easily': 0.60; 'more': 0.60
X-Injected-Via-Gmane	http://gmane.org/
To	python-list@python.org
From	Terry Reedy <tjreedy@udel.edu>
Subject	Re: how to inherit docstrings?
Date	Thu, 09 Jun 2011 23:59:08 -0400
References	<95cvmqF5b0U1@mid.individual.net> <b5497fa4-b79b-454e-b2e1-9e48642e2d85@glegroupsg2000goo.googlegroups.com>
Mime-Version	1.0
Content-Type	text/plain; charset=ISO-8859-1; format=flowed
Content-Transfer-Encoding	7bit
X-Gmane-NNTP-Posting-Host	rain.gmane.org
User-Agent	Mozilla/5.0 (Windows; U; Windows NT 5.1; en-US; rv:1.9.2.17) Gecko/20110414 Lightning/1.0b2 Thunderbird/3.1.10
In-Reply-To	<b5497fa4-b79b-454e-b2e1-9e48642e2d85@glegroupsg2000goo.googlegroups.com>
X-BeenThere	python-list@python.org
X-Mailman-Version	2.1.12
Precedence	list
List-Id	General discussion list for the Python programming language <python-list.python.org>
List-Unsubscribe	<http://mail.python.org/mailman/options/python-list>, <mailto:python-list-request@python.org?subject=unsubscribe>
List-Archive	<http://mail.python.org/pipermail/python-list>
List-Post	<mailto:python-list@python.org>
List-Help	<mailto:python-list-request@python.org?subject=help>
List-Subscribe	<http://mail.python.org/mailman/listinfo/python-list>, <mailto:python-list-request@python.org?subject=subscribe>
Newsgroups	comp.lang.python
Message-ID	<mailman.73.1307678408.11593.python-list@python.org> (permalink)
Lines	12
NNTP-Posting-Host	82.94.164.166
X-Trace	1307678408 news.xs4all.nl 49039 [::ffff:82.94.164.166]:41724
X-Complaints-To	abuse@xs4all.nl
Xref	x330-a1.tempe.blueboxinc.net comp.lang.python:7346

Show key headers only | View raw

On 6/9/2011 9:12 PM, Carl Banks wrote:

> Presumably, the reason you are overriding a method in a subclass is to change its behavior; I'd expect an inherited docstring to be inaccurate more often than not.  So I'd be -1 on automatically inheriting them.
>
> However, I'd be +1 easily on a little help from the language to explicitly request to inherit the docstring.

An empty docstring "" could be interpreted as 'ditto' ;-)
It would be useless otherwise.

-- 
Terry Jan Reedy

Thread

Re: how to inherit docstrings? Carl Banks <pavlovevidence@gmail.com> - 2011-06-09 18:12 -0700
  Re: how to inherit docstrings? Ben Finney <ben+python@benfinney.id.au> - 2011-06-10 11:42 +1000
  Re: how to inherit docstrings? Eric Snow <ericsnowcurrently@gmail.com> - 2011-06-09 20:37 -0600
  Re: how to inherit docstrings? Terry Reedy <tjreedy@udel.edu> - 2011-06-09 23:59 -0400
    Re: how to inherit docstrings? Steven D'Aprano <steve+comp.lang.python@pearwood.info> - 2011-06-10 09:48 +0000
  Re: how to inherit docstrings? Eric Snow <ericsnowcurrently@gmail.com> - 2011-06-09 22:41 -0600
  Re: how to inherit docstrings? Gregory Ewing <greg.ewing@canterbury.ac.nz> - 2011-06-10 19:16 +1200

csiph-web