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

[Jordan Rose]

> On Feb 11, 2016, at 16:00, Dave Abrahams via swift-evolution <swift-evolution at swift.org> wrote:
> 
> Doug and I reviewed these, and we don't think they work.  The right
> criterion for cocoa seems to be “pull ‘of’ into the base name unless—as
> Jordan suggested—it means “having.”  
> 
> Fortunately that seems to be easily determined.  After looking at all
> the APIs in Cocoa, “of” in the base name means “having” exactly when it
> is followed by one of the following words: “type,” “types,” “kind,”
> “size,” “length,” and maybe “stage” (we're trying to analyze
> removeModifiersOfStage
> <https://developer.apple.com/library/mac/documentation/SceneKit/Reference/SCNParticleSystem_Class/#//apple_ref/doc/uid/TP40014177-CH1-SW132 <https://developer.apple.com/library/mac/documentation/SceneKit/Reference/SCNParticleSystem_Class/#//apple_ref/doc/uid/TP40014177-CH1-SW132>>
> to figure out how “of”is being used—assistance welcome).

As usual, I object to hardcoded supposedly-exhaustive lists. I'd rather have people fix these up manually with NS_SWIFT_NAME and such.

Given that the parallel to -removeModifiersOfStage: is -addModifierForProperties:atStage:withBlock:, I think the stage is not being treated as part of the modifier.

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