Re: how to inherit docstrings?

Path	csiph.com!x330-a1.tempe.blueboxinc.net!usenet.pasdenom.info!gegeweb.org!de-l.enfer-du-nord.net!feeder2.enfer-du-nord.net!feeds.phibee-telecom.net!newsfeed.xs4all.nl!newsfeed5.news.xs4all.nl!xs4all!newsgate.cistron.nl!newsgate.news.xs4all.nl!post.news.xs4all.nl!not-for-mail
Return-Path	<ericsnowcurrently@gmail.com>
X-Original-To	python-list@python.org
Delivered-To	python-list@mail.python.org
X-Spam-Status	OK 0.006
X-Spam-Evidence	'H': 0.99; 'S': 0.00; 'own.': 0.03; "shouldn't": 0.07; 'pm,': 0.10; 'wrote:': 0.14; 'docstring': 0.16; 'docstrings': 0.16; 'finney': 0.16; 'hierarchy': 0.16; 'imo,': 0.16; 'inherited': 0.16; 'specified.': 0.16; 'cc:addr:python- list': 0.17; 'writes:': 0.19; 'header:In-Reply-To:1': 0.21; 'thu,': 0.22; 'cc:20': 0.22; 'cc:no real name:20': 0.23; 'gregory': 0.23; 'smart': 0.23; "doesn't": 0.25; 'url:mailman': 0.26; 'thanks.': 0.27; "i'm": 0.27; 'message-id:@mail.gmail.com': 0.28; 'subject:how': 0.29; 'subject:?': 0.29; 'explicitly': 0.29; 'cc:addr:python.org': 0.30; 'url:listinfo': 0.30; 'criticism': 0.30; 'ewing': 0.30; 'received:209.85.215': 0.30; 'received:209.85.215.46': 0.30; 'received:mail- ew0-f46.google.com': 0.30; 'propose': 0.32; "i'll": 0.34; 'received:google.com': 0.37; 'useful': 0.37; 'received:209.85': 0.37; 'url:python': 0.38; 'url:org': 0.38; 'subject:: ': 0.38; 'should': 0.39; 'received:209': 0.39; 'either': 0.39; 'happen': 0.60; 'more': 0.60; 'human': 0.62; 'entitled': 0.63; 'shield': 0.91
DKIM-Signature	v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=gamma; h=domainkey-signature:mime-version:in-reply-to:references:date :message-id:subject:from:to:cc:content-type :content-transfer-encoding; bh=fbC8wC1csX4kOV4pPs+MVd31C7t6M8C+xscjh1toKb4=; b=fNo+SP8Vy1o3TlqaQugpKE9Qo4hWpz/etnVMi+GzMSaG9Ker7UCtAP0ssHuEgUF5cO 9lOE/XxmleoU4MH8RyGnOXzDfznFkpKkoHZwKrCVYYhYyvcyCwsYX5FrioMIqegrPRI4 pYpYiSeYp22k/1vYRLm6M8VzpvyAkGArgpukg=
DomainKey-Signature	a=rsa-sha1; c=nofws; d=gmail.com; s=gamma; h=mime-version:in-reply-to:references:date:message-id:subject:from:to :cc:content-type:content-transfer-encoding; b=eVy4h5fNqD84LhBE8ssQYaD0O13UKmtkIB5G0F6ohZaSw6+WMq+hPPkzXBKdweLo66 0BGuX01CF+udg7DFaBExTjz2vB7+t3kRlITp5hAUmUapk/CbXeDjYnyPZEPd9rgotEKS 0ixEuloKFhs1QkFiW7YC9+Is0Zt6Wy1u3GdFU=
MIME-Version	1.0
In-Reply-To	<87ei32wpve.fsf@benfinney.id.au>
References	<BANLkTin3FGoxwvH2VDOb4OhAWi2Ea3K-pA@mail.gmail.com> <mailman.54.1307635040.11593.python-list@python.org> <95cvmqF5b0U1@mid.individual.net> <87ei32wpve.fsf@benfinney.id.au>
Date	Thu, 9 Jun 2011 17:31:35 -0600
Subject	Re: how to inherit docstrings?
From	Eric Snow <ericsnowcurrently@gmail.com>
To	Ben Finney <ben+python@benfinney.id.au>
Content-Type	text/plain; charset=windows-1252
Content-Transfer-Encoding	quoted-printable
Cc	python-list@python.org
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.66.1307662296.11593.python-list@python.org> (permalink)
Lines	31
NNTP-Posting-Host	82.94.164.166
X-Trace	1307662296 news.xs4all.nl 49174 [::ffff:82.94.164.166]:35480
X-Complaints-To	abuse@xs4all.nl
Xref	x330-a1.tempe.blueboxinc.net comp.lang.python:7332

Show key headers only | View raw

On Thu, Jun 9, 2011 at 5:23 PM, Ben Finney <ben+python@benfinney.id.au> wrote:
> Gregory Ewing <greg.ewing@canterbury.ac.nz> writes:
>
>> IMO, it shouldn't be necessary to explicitly copy docstrings around
>> like this in the first place. Either it should happen automatically,
>> or help() should be smart enough to look up the inheritance hierarchy
>> when given a method that doesn't have a docstring of its own.
>
> Since the docstrings are useful in more places than just ‘help’, I'm +1
> on having docstrings be automatically inherited if not specified.
>
> Would the OP like to propose this on ‘python-ideas’?
>

Yeah, I'll do that.  Thanks.

-eric

> --
>  \        “Odious ideas are not entitled to hide from criticism behind |
>  `\          the human shield of their believers' feelings.” —Richard |
> _o__)                                                         Stallman |
> Ben Finney
> --
> http://mail.python.org/mailman/listinfo/python-list
>

Back to comp.lang.python | Previous | Next — Previous in thread | Find similar | Unroll thread

Thread

Re: how to inherit docstrings? Ethan Furman <ethan@stoneleaf.us> - 2011-06-09 09:10 -0700
  Re: how to inherit docstrings? Gregory Ewing <greg.ewing@canterbury.ac.nz> - 2011-06-10 10:27 +1200
    Re: how to inherit docstrings? Eric Snow <ericsnowcurrently@gmail.com> - 2011-06-09 17:16 -0600
    Re: how to inherit docstrings? Ben Finney <ben+python@benfinney.id.au> - 2011-06-10 09:23 +1000
      Re: how to inherit docstrings? Eric Snow <ericsnowcurrently@gmail.com> - 2011-06-09 17:31 -0600

csiph-web