[swift-evolution] Some clarity lost from the great renaming
dabrahams at apple.com
Wed Oct 19 11:52:08 CDT 2016
on Tue Oct 18 2016, Hooman Mehr <hooman-AT-mac.com> wrote:
> Is changing the mapping of Cocoa API considered a source breaking
> change or can we report such incidents as bugs if we think they don’t
> match API guidelines?
You can report them as bugs even if it would be source breaking.
>> On Oct 18, 2016, at 6:43 PM, Dave Abrahams via swift-evolution <swift-evolution at swift.org> wrote:
>> on Tue Oct 18 2016, Brandon Knope <swift-evolution at swift.org <mailto:swift-evolution at swift.org>>
>>> I meant to bring this up a bit ago but just came across it again.
>>> I find this to not read properly:
>>> button.setTitle("Test", for: .normal) //for normal what?
>>> The for argument is really only clear in meaning when you are typing
>>> it out and see that it is a UIControlState type. While reading it
>>> without this context is it as clear? .normal doesn't seem descriptive
>>> enough on its own.
>>> Contrast this with UISegmentedControl:
>>> segmented.dividerImage(forLeftSegmentState: .normal, rightSegmentState: .normal, barMetrics:
>>> Here the parameter labels are needed because there needs to be a
>>> distinction in the method between left and right. But here it is not
>>> forLeft: or forRight: it is the much more clear forLeftSegmentState:
>>> So my question is: why was this not setTitle(forControlState:) or forButtonState, etc...?
>> This is really not an evolution question at this point. I suggest
>> filing radars against UIKit for things whose names could be improved.
>> swift-evolution mailing list
>> swift-evolution at swift.org <mailto:swift-evolution at swift.org>
More information about the swift-evolution