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
