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: [EMAIL PROTECTED]
www: http://www.ddanderson.com




Reply via email to