[Laszlo-dev] possible API change(s): LzNode attributes

Benjamin Shine ben at laszlosystems.com
Sat Oct 27 10:13:20 PDT 2007


Okay, I understand.

On Oct 27, 2007, at 9:34 AM, David Temkin wrote:

> Private means that the API is not a supported public API. The  
> reference defines the set of supported public APIs.
>
> If someone is using undocumented APIs, they're working outside of  
> the OL spec.
>
> If something outside the API spec is being used commonly, we should  
> consider creating a public API to cover the use case, which may or  
> may not correspond to the current private API. But that's not part  
> of the doc upgrade task.
>
> - D.
>
>
> On Oct 26, 2007, at 8:50 PM, Benjamin Shine wrote:
>
>>
>> Is that how we're defining private?
>>
>> Using isinited is pretty common (in my limited experience) -- I  
>> think it should be public.
>>
>> On Oct 26, 2007, at 8:39 PM, David Temkin wrote:
>>
>>> If they don't show up in the 3.4 docs... they're private by  
>>> definition... no?
>>>
>>> On Oct 26, 2007, at 8:22 PM, Benjamin Shine wrote:
>>>
>>>>
>>>> Several attributes appear in the 4.1 source, and are noticed by  
>>>> the js2doc tools, and appear in the 4.1 reference. Some, but not  
>>>> all, of these are used in 3.4, but they don't turn up in the 3.4  
>>>> documentation. We must decide whether they should be marked  
>>>> private, and thus suppressed in the documentation, or whether  
>>>> they are a new API, in which case they should be documented, and  
>>>> recorded as a new API. Here are the attributes of LzNode in  
>>>> question:
>>>> children
>>>> cloneNumber
>>>> defaultattrs
>>>> dependencies
>>>> doneclassroot
>>>> isinited
>>>> setters
>>>> sourceLocatorTable
>>>>
>>>> Tucker and David, ye old API review committee: what say you?
>>>>
>>>> On Oct 26, 2007, at 7:49 PM, Benjamin Shine wrote:
>>>>
>>>>>
>>>>> Same question for ignoreAttribute: it was defined in the schema  
>>>>> in 3.4, and doesn't seem to appear in 4.x. Is it no longer a  
>>>>> supported API?
>>>>>
>>>>>
>>>>> On Oct 26, 2007, at 7:42 PM, Benjamin Shine wrote:
>>>>>
>>>>>>
>>>>>> In lps3 docs, we list LzNode.class and describe it as "The CSS  
>>>>>> class of a node" -- see http://www.openlaszlo.org/lps3/docs/ 
>>>>>> reference/node.html
>>>>>>
>>>>>> This comment came from the schema -- in lzx.rnc in old trunk:
>>>>>> classAttribute =
>>>>>>   ## The CSS class of a node
>>>>>>   [lza:modifiers="final"]
>>>>>>   attribute class {token}
>>>>>>
>>>>>> In lps4, I don't think we still have this attribute. If I'm  
>>>>>> right, this is an API change.
>>>>>>
>>>>>> Tucker, is this an API change?
>>>>>>
>>>>>> This is being tracked as LPP-4973: http://jira.openlaszlo.org/ 
>>>>>> jira/browse/LPP-4973
>>>>>>
>>>>>> -ben
>>>>>>
>>>>>
>>>>
>>>
>>
>



More information about the Laszlo-dev mailing list