On Tue, 21 Sep 2010, thron7 wrote:

>>> On 09/21/2010 12:33 PM, Fritz Zaucker wrote:
>>>> Thanks for updating the API. Actually, I had problems finding that topic in
>>>> the API. Can you tell me, where to look?
>>>
>>> The class documentation of qx.core.Property:
>>> http://demo.qooxdoo.org/1.2/apiviewer/#qx.core.Property
>>
>> Should that be updated on the live website or did you update it in the
>> source and will be on the live site eventually? The current page says:
>
> It's in trunk, and will be live in the /devel/ path with the next
> update. 1.2.1 will have the update with its release.

Ok.

>> BTW, I think it is not that good to have an example in the manual that
>> only has two of three parameters.  Although I guess JS is very forgiving
>> as far as the number of actual parameters being passed is (too few, too
>> many) and does just nullify/undefine missing ones, I don't think it is
>> very good coding practise as far as maintenance of the code is concerned
>> (might have some performance benefits, but still).  Therefore I mentioned
>> that in the bug for re-consideration of also updating the manual ...
>
> No one before you either mentioned the third parameter, or was asking
> for it.

Must be my craziness, then ... ;-)

> Sometimes it is better to focus on the important parameters, and I'm
> entirely in favor of the manual featuring common use cases, and leave
> completeness to the reference, which is the API doc.  But I leave that
> discussion to others :).

What can I say except that my code would be a lot longer and repetitive
without this un-important parameter ...

Cheers,
Fritz

-- 
Oetiker+Partner AG              tel: +41 62 775 99 03 (direct)
Fritz Zaucker                        +41 62 775 99 00 (switch board)
Aarweg 15                            +41 79 675 06 30 (mobile)
CH-4600 Olten                   fax: +41 62 775 99 05
Schweiz                         web: www.oetiker.ch

------------------------------------------------------------------------------
Start uncovering the many advantages of virtual appliances
and start using them to simplify application deployment and
accelerate your shift to cloud computing.
http://p.sf.net/sfu/novell-sfdev2dev
_______________________________________________
qooxdoo-devel mailing list
[email protected]
https://lists.sourceforge.net/lists/listinfo/qooxdoo-devel

Reply via email to