ASDoc致命错误

Question

在使用ASDoc为我的Flex项目(用Flash Builder4.6构建)生成文档时，我遇到了一个错误：

[Fatal Error] toplevel.xml:3061:11: Element type "gmail.com" must be followed by either attribute specifications, ">" or "/>".
org.xml.sax.SAXParseException; systemId: path/to/toplevel.xml; lineNumber: 3061; columnNumber: 11; Element type "gmail.com" must be followed by either attribute specifications, ">" or "/>".
    at org.apache.xerces.parsers.DOMParser.parse(Unknown Source)
    at org.apache.xerces.jaxp.DocumentBuilderImpl.parse(Unknown Source)
    at javax.xml.parsers.DocumentBuilder.parse(DocumentBuilder.java:205)
    at flex2.compiler.asdoc.AsDocHelper.createTopLevelClasses(AsDocHelper.java:66)
    at flex2.compiler.asdoc.AsDocAPI.createTopLevelClassesXML(AsDocAPI.java:401)
    at flex2.tools.ASDoc.asdoc(ASDoc.java:94)
    at flex2.tools.ASDoc.main(ASDoc.java:35)
Error: Could not create toplevel.xml: Element type "gmail.com" must be followed by either attribute specifications, ">" or "/>".

它似乎试图在文档中使用我的电子邮件地址，但这不起作用。我在ASDoc模板目录中找不到与此相关的任何内容，也不知道ASDoc是如何知道我的电子邮件地址的。顺便说一句，在抛出错误之后，文件toplevel.xml不可用于检查。

Answer 1

ASDoc生成器给出的错误消息极具误导性。正在发生的事情在你的评论中的某处，你有一个“非法”的字符。

由于它告诉您错误消息与gmail.com有关，因此我猜测非法字符是at符号(@)。由于ASDoc生成器不会告诉您哪一行甚至哪一个类中包含无效字符，因此您需要深入研究项目中的每个类，直到在ASDoc注释中的某处找到@gmail.com。

找到后，将@字符替换为@，或者完全删除有问题的行。

有关更多详细信息，请参阅