[swift-evolution] [Guidelines, First Argument Labels]: Prepositions inside the parens

Douglas Gregor dgregor at apple.com
Thu Feb 11 15:46:54 CST 2016


> On Feb 11, 2016, at 1:44 PM, Jacob Bandes-Storch <jtbandes at gmail.com> wrote:
> 
> We've lost consistency between "indexOf(_ object:)", "indexOfObjects(_ opts: passingTest:)" and "indexes(ofObjectsPassingTest:)".
> 
> Also, what about "lonely to"? Are folks okay with "indexOfObjectIdentical(to: x)” ?

I don’t know if that’s a “lonely to” rule or whether “IdenticalTo” might be some kind of extended preposition, like “CompatibleWith”, where you want to treat the whole thing as a preposition.

	- Doug

> 
> Jacob
> 
> On Thu, Feb 11, 2016 at 1:35 PM, Douglas Gregor via swift-evolution <swift-evolution at swift.org <mailto:swift-evolution at swift.org>> wrote:
> 
>> On Feb 11, 2016, at 11:57 AM, Dave Abrahams <dabrahams at apple.com <mailto:dabrahams at apple.com>> wrote:
>> 
>> 
>> on Thu Feb 11 2016, Douglas Gregor <dgregor-AT-apple.com <http://dgregor-at-apple.com/>> wrote:
>> 
>>>> On Feb 11, 2016, at 10:53 AM, Dave Abrahams via swift-evolution <swift-evolution at swift.org <mailto:swift-evolution at swift.org>> wrote:
>>>> 
>>>> 
>>>> on Thu Feb 11 2016, Charles Kissinger <swift-evolution at swift.org <mailto:swift-evolution at swift.org>> wrote:
>>>> 
>>> 
>>>>> FWIW, I think these new guidelines strike a very nice balance between
>>>>> all of the competing concerns. The result of applying them to some of
>>>>> my own code could best be described as “different but not unpleasant”
>>>>> ;-)
>>>>> 
>>>>> In looking over the diffs, one nice result I didn’t expect is that
>>>>> moving the prepositional phrases into the first argument label seems
>>>>> to increase the speed with which I absorb the general intent of a
>>>>> function -- the “at a glance” understanding -- by moving a “detail”
>>>>> (important as it might be) into the parameter list. (The split
>>>>> prepositional phrases had the opposite effect for me.)
>>>> 
>>>> That's nice!  What do you think about moving “of” back out of the
>>>> parens?  Does that help or hurt?
>>> 
>>> And lo!, a diff appeared!
>>> 
>>> 	https://github.com/apple/swift-3-api-guidelines-review/commit/3f965346f1edea804a9bc6223d2824f43687e92f <https://github.com/apple/swift-3-api-guidelines-review/commit/3f965346f1edea804a9bc6223d2824f43687e92f>
>> 
>> Hmm, looking at these I think it's really the “lonely ‘of’” that we want
>> to pull out of the parens, i.e.
>> 
>>        indexOf(x)
>> 
>> but not
>> 
>>        animal(ofGenus: .reptile)
> 
> Lonely “of”s move to the base name:
> 
> 	https://github.com/apple/swift-3-api-guidelines-review/commit/f9cb1c468eee7cb827000911cad36e9e1b7fdfbc <https://github.com/apple/swift-3-api-guidelines-review/commit/f9cb1c468eee7cb827000911cad36e9e1b7fdfbc>
> 
> 	- Doug
> 
> 
> _______________________________________________
> swift-evolution mailing list
> swift-evolution at swift.org <mailto:swift-evolution at swift.org>
> https://lists.swift.org/mailman/listinfo/swift-evolution <https://lists.swift.org/mailman/listinfo/swift-evolution>
> 
> 

-------------- next part --------------
An HTML attachment was scrubbed...
URL: <https://lists.swift.org/pipermail/swift-evolution/attachments/20160211/59fd7c55/attachment.html>


More information about the swift-evolution mailing list