Path: csiph.com!x330-a1.tempe.blueboxinc.net!usenet.pasdenom.info!aioe.org!feeder.news-service.com!xlned.com!feeder5.xlned.com!newsfeed.xs4all.nl!newsfeed5.news.xs4all.nl!xs4all!newsgate.cistron.nl!newsgate.news.xs4all.nl!post.news.xs4all.nl!not-for-mail
Return-Path: <rosuav@gmail.com>
X-Original-To: python-list@python.org
Delivered-To: python-list@mail.python.org
X-Spam-Status: OK 0.008
X-Spam-Evidence: '*H*': 0.98; '*S*': 0.00; '"""': 0.07; '(it': 0.09; 'confuse': 0.09; 'pm,': 0.10; 'received:209.85.214.174': 0.14; 'received:mail-iw0-f174.google.com': 0.14; 'wrote:': 0.14; 'angelico': 0.16; 'arbitrarily.': 0.16; 'docstring': 0.16; 'finney': 0.16; 'from:addr:rosuav': 0.16; 'from:name:chris angelico': 0.16; 'describes': 0.19; 'writes:': 0.19; 'header:In- Reply-To:1': 0.21; 'fri,': 0.23; 'pass': 0.27; 'message- id:@mail.gmail.com': 0.28; 'received:209.85.214': 0.28; 'subject:how': 0.29; 'subject:?': 0.29; 'class': 0.29; 'to:addr :python-list': 0.33; 'chris': 0.34; 'else': 0.35; 'received:google.com': 0.37; 'issue': 0.37; 'something': 0.37; 'received:209.85': 0.37; 'subject:: ': 0.38; 'received:209': 0.39; 'to:addr:python.org': 0.39; 'hope': 0.60; 'designed': 0.65; 'attention': 0.67; 'draws': 0.91; 'notices': 0.93
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:content-type:content-transfer-encoding; bh=IpDHXMHKci0WUgdgKvqKp2QyTadYWs0AILICr1i5AtQ=; b=AFcmyRzIjPzNBrQ35+0WNA29IpeQTy1h6Sq2OUF+Xv0RCrd+HoULnTlToYuckXz0FI arfrWd2JH1bfq6MvBXHonZZ3qoOgdgWxmia2k93ALcbDpPrQEc3/QptKTYECTrOPqtTJ W1lqdnkjgkDpiyUixrmTEL9OqC3hh2Ss8ChSo=
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 :content-type:content-transfer-encoding; b=IRLFwLNLou/xpRcBrtrqIapI7yb/QlMyfJXVw+0i3I7CnkeIMtHx2wzKZuTToSln5z gRbZqv8RgNQtOoq0y/ZGVDZB2G8uRy+NZbVayxgBnxLM3O/BEcDPicx9HMMUVdXguWsS m5fnfJ/ZO8CMODA53Nx/OR02rYIfn1srINJOU=
MIME-Version: 1.0
In-Reply-To: <87r572uujj.fsf@benfinney.id.au>
References: <943d6cc1-5e1e-4f39-8003-6d70cbbed3a5@glegroupsg2000goo.googlegroups.com> <87vcweuuvp.fsf@benfinney.id.au> <87r572uujj.fsf@benfinney.id.au>
Date: Fri, 10 Jun 2011 15:39:36 +1000
Subject: Re: how to inherit docstrings?
From: Chris Angelico <rosuav@gmail.com>
To: python-list@python.org
Content-Type: text/plain; charset=ISO-8859-1
Content-Transfer-Encoding: quoted-printable
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.77.1307684379.11593.python-list@python.org>
Lines: 16
NNTP-Posting-Host: 82.94.164.166
X-Trace: 1307684379 news.xs4all.nl 49048 [::ffff:82.94.164.166]:60111
X-Complaints-To: abuse@xs4all.nl
Xref: x330-a1.tempe.blueboxinc.net comp.lang.python:7352

On Fri, Jun 10, 2011 at 3:25 PM, Ben Finney <ben+python@benfinney.id.au> wr=
ote:
> Ben Finney <ben+python@benfinney.id.au> writes:
>
>> class Square(Shape):
>> =A0 =A0 """ An equal-sided quadrilateral polygon. """
>
> That this docstring is imprecise (it describes any rhombus, not
> necessarily a square) is something I hope no-one else notices or draws
> attention to.

class Square(Number):
    """ A class designed to confuse the issue arbitrarily. """
    pass

Chris Angelico