How do I troubleshoot an "Error #1090" trying to generate ASDoc?

Question

I've got a reasonably large Flex project and I'm trying to generate ASDoc documentation for it. When I run asdoc, it gives me this 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)

I found a closed as could-not-reproduce bug in Jira about single-quotes in a double-quoted public field initialiser, but I don't have any of those. Any clues?

Answer 1

@Amarghosh prompted me to try running ASDoc individually on my classes, and it turns out that the error is due to a malformed ASDoc comment in my source:

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

needs to be:

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