It's our habit to add these things for reference. I can say that I refer to the source as documentation all the time. I'm in TextMate and I can open the actual file to look at its API faster than I can bring up a web browser.
Note that we've started updating these (at least in -more) to include the arguments the methods are passed, i.e. /* onShow: $empty(element, somethingElse), onClick: $empty(event), etc */ On Mon, Jan 4, 2010 at 11:14 AM, Rolf -nl <[email protected]> wrote: > I never fully understood the use of the following: > > /* > onClick: $empty, > onClose: $empty, > onWhatever: $empty, > ...*/ > > in class options that some people put it. These are just for your > reference so you know these events are used in the class, right? (i > mean, they are commented out anyway) Personally I don't add em.... but > should I? >
