[Laszlo-dev] debugging doc errors

[Sarah Allen]

Before checking in the changeset below, I thought I would check the  
docs.  Building the docs fails, but I can't figure out what the error  
is... I don't see any changes to rtmpconnection in my changeset that  
would cause a doc failure.

reference.frameset.generate:
      [echo] ***gonna copy in reference frameset ***
      [copy] Copying 1 file to /Users/sarah/src/svn/openlaszlo/trunk/ 
docs/reference
      [copy] Copying /Users/sarah/src/svn/openlaszlo/trunk/docs/src/ 
reference/navbuilder/index-generated.html to /Users/sarah/src/svn/ 
openlaszlo/trunk/docs/reference/index-generated.html
      [copy] Copying 1 file to /Users/sarah/src/svn/openlaszlo/trunk/ 
docs/reference
      [copy] Copying 1 file to /Users/sarah/src/svn/openlaszlo/trunk/ 
docs/reference
      [copy] Copying 2 files to /Users/sarah/src/svn/openlaszlo/trunk/ 
docs/reference
      [exec] Warning: toc.xml has title  
"<autocompletecombobox>" and tags.xml does not list it
      [exec] Warning: toc.xml has title "<textstyle>"  
and tags.xml does not list it
      [exec] Warning: toc.xml has title "<font>" and  
tags.xml does not list it
      [exec] Warning: toc.xml has title "lz.Param" and classes.xml has  
"lz.params"
      [exec] Warning: toc.xml has title  
"<basedragimage>" and tags.xml does not list it
      [exec] Warning: toc.xml has title "<baseedittext>"  
and tags.xml does not list it
      [exec] Warning: toc.xml has title "<basetooltip>"  
and tags.xml does not list it
      [exec] Warning: toc.xml has title  
"<basevalidator>" and tags.xml does not list it
      [exec] Error: broken link in doc navigation:  
lz.rtmpconnection.html referenced from toc.xml does not exist
      [exec]     maybe use lz.html?
      [exec]     maybe use lz.html.html?
      [exec] Warning: toc.xml has title  
"<rtmpconnection>" and tags.xml does not list it
      [exec] Warning: toc.xml has title "Debug" and classes.xml has  
"lz.Debug"
      [exec] 2 TODOs found in toc.xml
      [exec] Error: docs/src/nav/toc.xml is out of date, see broken  
link messages above

Syncing to a clean version of trunk, the doc build says that it  
succeeds despite this so-called fatal error:

js2doc:
      [java] [Fatal Error] :3:11: The element type "fragment" must be  
terminated by the matching end-tag "</fragment>".
      [java] Jun 5, 2009 9:22:42 PM org.openlaszlo.js2doc.JS2DocUtils  
setXMLContent
      [java] WARNING: Could not parse comment '<fragment>a reference  
to the stream to enable direct control,
      [java]               such as vp.steam.play or vp.stream.seek(20)
      [java]         </canvas></fragment>'
      [java] org.xml.sax.SAXParseException: The element type  
"fragment" must be terminated by the matching end-tag "</fragment>".
      [java] 	at org.apache.xerces.parsers.DOMParser.parse(Unknown  
Source)
      [java] 	at  
org.apache.xerces.jaxp.DocumentBuilderImpl.parse(Unknown Source)
      [java] 	at  
org.openlaszlo.js2doc.JS2DocUtils.setXMLContent(JS2DocUtils.java:118)
      [java] 	at  
org.openlaszlo.js2doc.Comment.appendAsXML(Comment.java:273)
      [java] 	at  
org 
.openlaszlo 
.js2doc.ReprocessComments.reprocessElement(ReprocessComments.java:514)
      [java] 	at  
org 
.openlaszlo.js2doc.ReprocessComments.reprocess(ReprocessComments.java: 
569)
      [java] 	at  
org 
.openlaszlo 
.js2doc 
.ReprocessComments.reprocessChildElements(ReprocessComments.java:524)
      [java] 	at  
org 
.openlaszlo.js2doc.ReprocessComments.reprocess(ReprocessComments.java: 
574)
      [java] 	at  
org 
.openlaszlo 
.js2doc 
.ReprocessComments.reprocessChildElements(ReprocessComments.java:524)
      [java] 	at  
org 
.openlaszlo.js2doc.ReprocessComments.reprocess(ReprocessComments.java: 
574)
      [java] 	at  
org 
.openlaszlo 
.js2doc 
.ReprocessComments.reprocessChildElements(ReprocessComments.java:524)
      [java] 	at  
org 
.openlaszlo.js2doc.ReprocessComments.reprocess(ReprocessComments.java: 
535)
      [java] 	at  
org 
.openlaszlo 
.js2doc 
.ReprocessComments.reprocessChildElements(ReprocessComments.java:524)
      [java] 	at  
org 
.openlaszlo.js2doc.ReprocessComments.reprocess(ReprocessComments.java: 
593)
      [java] 	at org.openlaszlo.js2doc.Main.reprocess(Main.java:244)
      [java] 	at org.openlaszlo.js2doc.Main.js2doc(Main.java:179)
      [java] 	at org.openlaszlo.js2doc.Main.main(Main.java:57)
      [java] Jun 5, 2009 9:22:43 PM  
org.openlaszlo.js2doc.ReprocessComments$ParamFieldFilter handleField


>>> Change 20090602-sallen-N by sallen at sallen-mac.local on 2009-06-02  
>>> 17:47:32 PDT
>>>   in /Users/sarah/src/svn/openlaszlo/trunk
>>>   for http://svn.openlaszlo.org/openlaszlo/trunk
>>> Summary: added independed scrubber and progress components
>>> New Features: new components designed for use with videoview
>>> Bugs Fixed:
>>> Technical Reviewer: max
>>> QA Reviewer: (pending)
>>> Doc Reviewer: (pending)
>>> Documentation: components documented inline, should show up in  
>>> reference
>>> Release Notes:
>>> Details: These compnents allow you to create your own video player  
>>> that has a different layout.  I feel like the videoplayer  
>>> component should be updated to use these, but there is a feature  
>>> they don't support (showing the amount of buffer) which you can  
>>> see in the YouTube demo.  Since I can't test that feature outside  
>>> of the YouTube app, I can't really implement it.
>>> * videoview onstream event wasn't sent when stream created by URL
>>> * mediastream: fixes to seek/pause behavior (revealed by work on  
>>> the scrubber)
>>> Tests: test-scrubber.lzx
>>> Files:
>>> A      test/video/test-scrubber.lzx
>>> A      test/video/resources
>>> A      test/video/resources/gradient.png
>>> M      WEB-INF/lps/misc/lzx-autoincludes.properties
>>> M      lps/components/extensions/av/mediastream.lzx
>>> M      lps/components/extensions/av/videoview.lzx
>>> M      lps/components/extensions/av/rtmpconnection.lzx
>>> A      lps/components/av/streamscrubber.lzx
>>> A      lps/components/av/streamprogress.lzx
>>> Changeset: http://svn.openlaszlo.org/openlaszlo/patches/20090602-sallen-N.tar
-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://www.openlaszlo.org/pipermail/laszlo-dev/attachments/20090605/bcc379f1/attachment-0001.html