Path: csiph.com!v102.xanadu-bbs.net!xanadu-bbs.net!feeder.erje.net!eu.feeder.erje.net!feeds.phibee-telecom.net!newsfeed.xs4all.nl!newsfeed3.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.011
X-Spam-Evidence: '*H*': 0.98; '*S*': 0.00; 'referring': 0.07; 'subject: -- ': 0.07; 'received:80.91': 0.09; 'received:80.91.229': 0.09; 'received:gmane.org': 0.09; 'received:list': 0.09; 'spelling': 0.09; 'thus,': 0.09; 'subject:question': 0.10; 'identifiers.': 0.16; 'kern': 0.16; 'received:80.91.229.3': 0.16; 'received:plane.gmane.org': 0.16; 'roy': 0.16; 'subject:class': 0.16; 'underlying': 0.16; 'wrote:': 0.18; 'seems': 0.21; 'code,': 0.22; 'header:User-Agent:1': 0.23; 'certainly': 0.24; 'interpret': 0.24; 'class.': 0.26; 'header:X -Complaints-To:1': 0.27; 'header:In-Reply-To:1': 0.27; 'robert': 0.30; "i'm": 0.30; 'markup': 0.31; 'class': 0.32; 'but': 0.35; 'there': 0.35; 'subject:?': 0.36; 'list': 0.37; 'to:addr:python- list': 0.38; 'to:addr:python.org': 0.39; 'received:org': 0.40; 'how': 0.40; 'first': 0.61; 'name': 0.63; 'our': 0.64; 'more': 0.64; 'world': 0.66; 'services': 0.66; 'believe': 0.68; 'smith': 0.68; 'inline': 0.74; 'adopting': 0.84; 'eco': 0.84; 'terrible': 0.84; 'received:86': 0.91
X-Injected-Via-Gmane: http://gmane.org/
To: python-list@python.org
From: Robert Kern <robert.kern@gmail.com>
Subject: Re: Style question -- plural of class name?
Date: Thu, 09 May 2013 18:44:17 +0100
References: <kmec30$d12$1@panix2.panix.com>
Mime-Version: 1.0
Content-Type: text/plain; charset=UTF-8; format=flowed
Content-Transfer-Encoding: 7bit
X-Gmane-NNTP-Posting-Host: cpc2-cmbg17-2-0-cust347.5-4.cable.virginmedia.com
User-Agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10.8; rv:17.0) Gecko/20130328 Thunderbird/17.0.5
In-Reply-To: <kmec30$d12$1@panix2.panix.com>
X-BeenThere: python-list@python.org
X-Mailman-Version: 2.1.15
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.1499.1368121471.3114.python-list@python.org>
Lines: 35
NNTP-Posting-Host: 2001:888:2000:d::a6
X-Trace: 1368121471 news.xs4all.nl 15906 [2001:888:2000:d::a6]:46956
X-Complaints-To: abuse@xs4all.nl
Xref: csiph.com comp.lang.python:45049

On 2013-05-08 21:20, Roy Smith wrote:
> FooEntry is a class.  How would you describe a list of these in a
> docstring?
>
> "A list of FooEntries"
>
> "A list of FooEntrys"
>
> "A list of FooEntry's"
>
> "A list of FooEntry instances"
>
> The first one certainly sounds the best, but it seems wierd to change
> the spelling of the class name to make it plural.

I'm using services like Github more and more to talk about code, so I have taken 
to adopting its inline markup for `code` when referring to identifiers. Thus, I 
will often write

   A list of `FooEntry`s

But I don't mind

   A list of FooEntries

Hopefully there isn't also a `FooEntries` class.

-- 
Robert Kern

"I have come to believe that the whole world is an enigma, a harmless enigma
  that is made terrible by our own mad attempt to interpret it as though it had
  an underlying truth."
   -- Umberto Eco