¿Cómo soluciono un “Error # 1090” tratando de generar ASDoc?

Question

Tengo un proyecto bastante grande Flex y estoy tratando de generar la documentación ASDoc por ello. Cuando corro asdoc, me da este error:

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)

He encontrado una cerrada como podía, sin reproducir error en Jira sobre las comillas sencillas en un inicializador entre comillas dobles ámbito público, pero no tengo nada de eso. ¿Alguna pista?

Answer 1

Me @Amarghosh pedirá que intente ejecutar ASDoc individualmente en mis clases, y resulta que el error se debe a un comentario ASDoc con formato incorrecto en mi fuente:

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

tiene que ser:

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