كيف يمكنني استكشاف الأخطاء وإصلاحها "خطأ # 1090" في محاولة لتوليد ASDOC؟

Question

لدي مشروع فليكس كبير بشكل معقول وأنا أحاول توليد وثائق ASDOC لذلك. عندما أركض ASDOC، يعطيني هذا الخطأ:

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)

لقد وجدت مغلقا كما لا يتم إعادة إنتاج علة في جيرا حول اقتباسات واحدة في مهاجمة ذات طابع عام مزدوج، لكن ليس لدي أي من هؤلاء. أي أدلة؟

Answer 1

دفعني amarghosh في محاولة تشغيل ASDOC بشكل فردي على فصولي، واتضح أن الخطأ يرجع إلى تعليق ASDOC مشوه في مصدري:

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

يجب أن يكون:

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