Re: [Telephony] CallHandler.conference terminology is confusing

On Tue, Apr 16, 2013 at 11:53 PM, Josh Soref <jsoref@blackberry.com> wrote:
>> CallHandler.conference [1] conference of type boolean, readonly It MUST return true if the call is a ConferenceCall, otherwise the object MUST be a TelephonyCall object and it MUST return false.
>
> It's really hard to figure out what `the call`, `the object`, and `it` are...
>
> Note that in Navigator.telephony, you use `this object`, which is something that I can understand.
>
> I think field is intended as a "fast" equivalent of `this instanceof ConferenceCall` / `this instanceof TelephonyCall` (note that it's likely to be much slower than instanceof in most engines).

Thanks for the hints, I will reformulate.

>
> But it also indicates a case of inheritance where one isn't really needed. Iirc there was a discussion during one of the slots (probably messaging) about replacing inheritance with copied out content. The inheritance that you're describing here is an implementation detail, and it's fairly easy to write native code which happens to have this implementation detail w/o exposing this useless detail to JS (see discussion about SMS/MMS).

The intersection of property+eventhandlers+methods sets of
ConferenceCall and TelephonyCall is the set of
properties+eventhandlers+methods of CallHandler.
I would like to avoid documenting the same things in 2 places.
What is the suggested solution?

>
> [1] http://telephony.sysapps.org/#widl-CallHandler-conference
>

Thanks,
Zoltan

Received on Wednesday, 17 April 2013 10:26:15 UTC