Figuring out how to generate documention for ActionScript 3/Flex 4 code using Adobe's ASDoc tool from within Flash Builder has been quite a journey.

Helpful information:

• http://www.peterelst.com/blog/2009/06/08/flash-builder-4-beta-exporting-asdoc-documentation/ This was the most helpful resource that I found! Found by searching Google for "Flash Builder" asdoc

• http://wiki.github.com/viatropos/style/workflow-tips Solution to ASDoc errors, found by googling for asdoc "[Fatal Error] toplevel.xml"

• All the text content in the comments must resolve to valid HTML. For example, <> does not validate with the SAX parser that ASDoc uses, so you would instead need to do <>. Also the character & by itself is invalid, use & instead.

• http://livedocs.adobe.com/flex/3/html/help.html?content=asdoc_1.html

Things that didn't work:

• The program called "ASDocr" wouldn't even install.
• the instructions at undefined-type.com/2008/11/asdoc-with-flex-compiler/ were good, but for a
• visiblearea.com/visdoc/
• stackoverflow.com/questions/129405/can-i-use-doxygen-to-document-actionscript-code Basically, it's not a good idea to use DoxyGen for AS3. DoxyGen can word wonferfully for other things though..