> On Apr 7, 2015, at 5:47 PM, Mike Kienenberger <mkien...@gmail.com> wrote: > > On Tue, Apr 7, 2015 at 10:37 AM, Andrus Adamchik <and...@objectstyle.org> > wrote: >>> Even though it may not be as concise, using "alternate form of" might >>> be less confusing. >> >> I assume you are talking about "limit" comment, not "select"? > > No, I was referring to "select". > > Essentially the alternate form of "ObjectContext.selectOne(Select)" > > We could probably also drop "Essentially the" from anywhere it is > being used and use > > An alternate form of "ObjectContext.selectOne(Select)" > > 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