Actionscript 3 ASDoc致命错误

使用ASDoc为我的Flex项目（使用Flash Builder 4.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 templates目录中找不到任何与此相关的内容，我不知道ASDoc如何知道我的电子邮件地址。顺便说一句，抛出错误后，文件toplevel.xml不可用于检查。

ASDoc生成器给出的错误消息具有严重的误导性。发生的事情是在你的评论中的某个地方，你有一个“非法”的角色

由于它告诉您错误消息与

gmail.com

有关，我猜非法字符是at符号（

@

）。由于ASDoc生成器不会告诉您哪一行或哪一个类中有无效字符，因此您需要深入研究项目中的每个类，直到在ASDoc注释中找到

@gmail.com

找到后，将

@

字符替换为

@，或完全删除有问题的行

有关详细信息，请参阅