Como faço para solucionar um "erro nº 1090" tentando gerar ASDOC?

Question

Eu tenho um projeto Flex razoavelmente grande e estou tentando gerar documentação do ASDOC para ele. Quando eu corro ASDOC, isso me dá esse erro:

An unexpected error occurred.
Error #1090: XML parser failure: element is malformed.

(Location of error unknown)XSLT Error (javax.xml.transform.TransformerException): java.io.FileNotFoundException: C:\projects\projectname\asdoc\toplevel_classes.xml (The system cannot find the file specified)

Encontrei um fechado como poderia não-reproduzir Bug em Jira Sobre citações únicas em um inicializador de campo público de duas citadas, mas não tenho nada. Alguma pista?

Answer 1

@Amarghosh me levou a tentar executar asdoc individualmente em minhas aulas, e acontece que o erro é devido a um comentário de ASDOC malformado na minha fonte:

    /**
     * @see Blah.blah
     *
     * Furbles the whatsit.
     */

precisa ser:

    /**
     * Furbles the whatsit.
     *
     * @see Blah.blah
     */