« Fewer feeds, more favorites on average
Vienna 2.2: Twice as good »

Do as we say, not as we do

From the Coding Guidelines for Cocoa:

Avoid ambiguity in API names, such as method names that could be interpreted in more than one way.

sendPort

Does it send the port or return it?

displayName

Does it display a name or return the receiver’s title in the user interface?

From the Cocoa API:

-[NSConnection sendPort]

-[NSPortMessage sendPort]

-[NSDocument displayName]

-[NSFont displayName]

This entry was posted on Thursday, August 30th, 2007 at 6:42 pm and is filed under Apple, Cocoa. You can follow any responses to this entry through the RSS 2.0 feed. Responses are currently closed, but you can trackback from your own site.

One Response to “Do as we say, not as we do”

  1. Peter Hosey Says:
    August 30th, 2007 at 8:02 pm

    To say nothing of all their HIG violations.