[Laszlo-dev] doc roundup: LzAudioKernel. LzCSSStyle, LzUtilsClass

[Donald Anderson]

1) LzAudioKernel is marked public in the swf9 kernels, in other kernels,
it is a public variable (a hand crafted class).  It does not appear in  
the docs
(not sure why it isn't picked up as 'swf9 only').

Should it be public?  This somewhat implies it should be
    - documented
    - published as lz.AudioKernel
    - non swf versions rewritten as 'class LzAudioKernel'

Partial solutions are possible (if justified)!

2) The services/LzCSSStyle.lzs file is marked with a '@access public'  
header.
This means (I think!) that any classes not otherwise marked are public  
in documentation.
LzCSSStyleRule, LzCSSStyleClass, LzCSSStyleDeclaration are thus marked  
public,
though they have little or any javadoc to support them.  They are  
currently published
in the lz object as well.  Can I assume this whole file should be  
private?

3) lz.Utils is published as a singleton LzUtilsClass:
   lz.Utils = new LzUtilsClass();
But LzUtilsClass is not public, so should it be published in lz?

- Don


--

Don Anderson
Java/C/C++, Berkeley DB, systems consultant

voice: 617-547-7881
email: dda at ddanderson.com
www: http://www.ddanderson.com



-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://www.openlaszlo.org/pipermail/laszlo-dev/attachments/20080805/f6279d6d/attachment.html