Groups | Search | Server Info | Keyboard shortcuts | Login | Register [http] [https] [nntp] [nntps]

Groups > comp.lang.python > #7328

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!feeder.news-service.com!news2.euro.net!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.003
X-Spam-Evidence '*H*': 0.99; '*S*': 0.00; 'own.': 0.03; 'compiler': 0.07; "shouldn't": 0.07; 'pm,': 0.10; 'wrote:': 0.14; 'docstring': 0.16; 'docstrings': 0.16; 'hierarchy': 0.16; 'imo,': 0.16; 'inheriting': 0.16; 'unbound': 0.16; 'cc:addr:python-list': 0.17; 'classes,': 0.19; 'header:In-Reply-To:1': 0.21; 'thu,': 0.22; 'cc:2**0': 0.22; 'cc:no real name:2**0': 0.23; 'gregory': 0.23; 'smart': 0.23; "doesn't": 0.25; 'greg': 0.25; 'url:mailman': 0.26; '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; 'cases.': 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; 'received:google.com': 0.37; 'received:209.85': 0.37; 'url:python': 0.38; 'url:org': 0.38; 'subject:: ': 0.38; 'some': 0.38; 'should': 0.39; 'received:209': 0.39; 'either': 0.39; 'needed.': 0.40; 'help': 0.40; 'happen': 0.60; 'auto': 0.63; 'nice,': 0.84
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; bh=OXBtQPFpv6SMEnkJZRw4bTSsEld9Ji/8OfZnle615oc=; b=FcTjfHPxcEZsbCOZ6F7UtnEv8vFwJs6s46JBoJCJNSFZPIUuFs/L4gUuMifNSUzi2j ULn4epB0SfMP+KfZQd4ePgmw/M3bN8J6U4B0ebUujG3WDonps2fYt673XlJ7dlkSnIhO cs3FcMMcskCYFw1vNuHjI5h/B4dl5Jy20UKYg=
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; b=QArmyaExu/89Gjb00jZiLTCZYqxiMy9KtdpZ/almVcrmG/umCpXdVBXMkrOxFl5g/+ iYubwD7JcKKf7ZFB82hUvbeYWzeTxzAb5QTCfAydDuniMAa0eaZrmCGJv5MJD2Ygl22E DTgqYr+s2cfMFZGRMqogvFSWj/mh3bzbRXGE4=
MIME-Version 1.0
In-Reply-To <95cvmqF5b0U1@mid.individual.net>
References <BANLkTin3FGoxwvH2VDOb4OhAWi2Ea3K-pA@mail.gmail.com> <mailman.54.1307635040.11593.python-list@python.org> <95cvmqF5b0U1@mid.individual.net>
Date Thu, 9 Jun 2011 17:16:47 -0600
Subject Re: how to inherit docstrings?
From Eric Snow <ericsnowcurrently@gmail.com>
To Gregory Ewing <greg.ewing@canterbury.ac.nz>
Content-Type text/plain; charset=ISO-8859-1
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.64.1307661415.11593.python-list@python.org> (permalink)
Lines 24
NNTP-Posting-Host 82.94.164.166
X-Trace 1307661415 news.xs4all.nl 49039 [::ffff:82.94.164.166]:56407
X-Complaints-To abuse@xs4all.nl
Xref x330-a1.tempe.blueboxinc.net comp.lang.python:7328

Show key headers only | View raw

On Thu, Jun 9, 2011 at 4:27 PM, Gregory Ewing
<greg.ewing@canterbury.ac.nz> wrote:
> 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.
>

Auto inheriting docstrings would be nice, in some cases.  WRT help(),
keep in mind that docstrings are used for a bunch of other things,
like doctests and some DSLs.

-eric

> Unfortunately, since unbound methods were ditched,
> help(Foo.blarg) no longer has an easy way to find the base
> classes, so help from the compiler may be needed.
>
> --
> Greg
> --
> http://mail.python.org/mailman/listinfo/python-list
>

Back to comp.lang.python | Previous | Next — Previous in thread | Next 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