Come faccio a risolvere un “Errore # 1090” cercando di generare ASDoc?

Question

Ho un ragionevolmente grande progetto Flex e sto cercando di generare la documentazione ASDoc per esso. Quando eseguo ASDoc, mi dà questo errore:

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)

Ho trovato un chiusa come potrebbe-non-riprodurre bug in Jira circa apostrofi in un campo pubblico initialiser doppio citato, ma non ho una di queste. Eventuali indizi?

Answer 1

@Amarghosh mi ha spinto a provare a eseguire ASDoc singolarmente su mie classi, e si scopre che l'errore è dovuto ad un commento ASDoc non valido in mia fonte:

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

deve essere:

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