Mailing-List: contact dev-help@cayenne.apache.org; run by ezmlm
Precedence: bulk
Reply-To: dev@cayenne.apache.org
Received-SPF: pass (athena.apache.org: local policy)
Content-Type: text/plain; charset=iso-8859-1
Mime-Version: 1.0 (Mac OS X Mail 8.2 \(2070.6\))
Subject: Re: New features in Select API
From: Andrus Adamchik <andrus@objectstyle.org>
In-Reply-To: 
 <CAM1yOjbT06JxNVyeZPaybGmVwp21Xkg7PkSowPdPRchDJM_YAg@mail.gmail.com>
Date: Tue, 7 Apr 2015 17:51:44 +0300
Content-Transfer-Encoding: quoted-printable
Message-Id: <9B9577A2-4530-41AE-90A3-53F3450F8B44@objectstyle.org>
References: 
 <CAAWAmOfRo1_iFhdb2M4W3McJEoz_45t6ubJYRrZu2s-S7UdmtQ@mail.gmail.com>
 <CAA-upzo5KW1RgX+p1LjrZgDLU4WJjsHroOp3iSax5BOOR7n1bw@mail.gmail.com>
 <9659852B-5274-4875-AA77-E0184BA83B1A@objectstyle.org>
 <CAM1yOjYJx5Jzb=9YW60ArVk-W3V342RFRMb1vYfjXqws9jTvYA@mail.gmail.com>
 <9E44E958-DE1C-48A7-A383-0EBFE7B69F69@objectstyle.org>
 <CAM1yOjbT06JxNVyeZPaybGmVwp21Xkg7PkSowPdPRchDJM_YAg@mail.gmail.com>
To: dev@cayenne.apache.org


> On Apr 7, 2015, at 5:47 PM, Mike Kienenberger <mkienenb@gmail.com> =
wrote:
>=20
> On Tue, Apr 7, 2015 at 10:37 AM, Andrus Adamchik =
<andrus@objectstyle.org> wrote:
>>> Even though it may not be as concise, using "alternate form of" =
might
>>> be less confusing.
>>=20
>> I assume you are talking about "limit" comment, not "select"?
>=20
> No, I was referring to "select".
>=20
>    Essentially the alternate form of "ObjectContext.selectOne(Select)"
>=20
> We could probably also drop "Essentially the" from anywhere it is
> being used and use
>=20
>    An alternate form of "ObjectContext.selectOne(Select)"
>=20
> Michael's "equivalent" is also fine.  Or "A fluent alternative to"
> might be better still.

I am +1 on your and Mike's suggestions. So if anyone would like to take =
a shot at cleaning up this javadoc for Select and implemebtign =
subclasses, please do.

Andrus=