Kristen Sindac - [10/31/08 02:54 PM ] Can you give more information about your project? Is it an AS project? Does it only occur when using java 1.6? What happens if you use jdk 1.5?

Joel Birchler - [10/31/08 05:29 PM ] I have the same issue on some of the projects that I try to document. I am running java 1.5.0_16 on Mac OS X 10.5.5. It does not occur on all projects. The one it fails on is using modules and has plenty of libraries. Are there any log files that I can send you to help out?

Kristen Sindac - [11/03/08 12:26 PM ] Joel, Is there a validation_errors.log in the asdoc output folder? If not, can you try narrowing down which source in your project causes the error and possibly post reproducible test files in this issue? You can try generating asdoc -doc-sources on specific packages only to narrow it down. Having a reproducible test file will help investigate the issue. Thanks!

Joel Birchler - [11/06/08 01:44 PM ] I have narrowed it down to a class that is using comments like this: /**          * Uses the folowing thresholds to calculate the diskSpaceRating: <rule id="4" name="changedForConfidentiality0" category="changedForConfidentiality1"> <![CDATA[//entry[@key='changedForConfidentiality2'] > 70]]> </rule> <rule id="5" name="availableDiskSpaceOK" category="diskSpaceRating"> <![CDATA[//entry[@key='changedForConfidentiality3'] > 30]]> </rule>          * @return          *          */ If I delete that comment. It works. It appears to be the CDATA tag in XML. /**          *          * Testing...          *          * <foo>          * <![CDATA[bar]]>          * </foo>          *          */ My simplified example returns this error (running from ant):  [exec] Loading configuration file /Developer/SDKs/Flex3.1.0/frameworks/flex-config.xml      [exec] An unexpected error occurred.      [exec] Error #1085: The element type "description" must be terminated by the matching end-tag "</description>".      [exec]      [exec] (Location of error unknown)XSLT Error (javax.xml.transform.TransformerException): java.io.FileNotFoundException: /Users/Joel/p4depot/depot/Premium_Services/ADAPT/1.5/rev_TRUNK/WebClient/ClientAppModule/doc/toplevel_classes.xml (No such file or directory) BUILD FAILED /Users/Joel/p4depot/depot/Premium_Services/ADAPT/1.5/rev_TRUNK/WebClient/ClientAppModule/build.xml:17: exec returned: 255

Joel Birchler - [11/06/08 01:46 PM ] Also, I didn't see a validation_errors.log.

Kristen Sindac - [11/06/08 03:23 PM ] I think the error in your example is caused by the use of '<' and '>' symbols in the asdoc comment. Replace these symbols with: &lt; for Less-than operator (<) . &gt; for Greater-than operator (>). This is documented here: http://livedocs.adobe.com/flex/3/html/help.html?content=asdoc_3.html ex. /** * * Testing... * * &lt;foo&gt; * &lt;![CDATA[bar]]&gt; * &lt;/foo&gt; * */

Kristen Sindac - [11/24/08 05:27 PM ] Setting this as Cannot Reproduce. I haven't been able to reproduce the error as described in this bug. A reproducible test file will help investigate the issue. For the other error reported in the comments section, I'm able to reproduce that and it's not a bug. See my previous comment for details.