[Laszlo-dev] doc complication due to merged sources

[Donald Anderson]

It appears that the things we have in LaszloLibrary.lzs confuse the  
docs a bit:

if ($swf9) {

   #include "core/Library.lzs"
   #include "events/Library.lzs"
   ....


} else {
....

   #include "core/Library.lzs"
   #include "events/Library.lzs"
   ....
}

js2doc for this will create separate doc pages for virtually page in  
reference:
   LzNode+sw9.html
   LzNode+dhtml+j2me+svg+swf7+swf8.html

and they'll differ only by claiming that one is for SWF9  and the  
other is for
all the other runtimes.  And it breaks any hardcoded links, the  
navigation pane, etc.

I think this can all be avoided by some rearrangement of the if  
statements
in LaszloLibrary.lzs to merge the common elements into one path.
I'm doing this now.  Until this is done, doc will look funny and the
table of contents will be pretty broken.

There are some classes that still aren't merged, right?  That's okay,  
I'd
much rather deal with a small subset.  I'm really glad you
all did the file merges that you have already.  I guess as we converge
on Monday, we'll need to 'freeze' any class/file merging activity
so I can make sure the nav all plays well.  If nobody is doing it
now, perhaps it's a good time to freeze.

- Don


--

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

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