كيفية الحصول على doxygen لتشغيل أسرع؟

Question

وDoxygen هو بطيئة بعض الشيء - يستغرق حوالي بضع دقائق لمعالجة مشروعي كله، وذلك لتغييرات تدريجية صغيرة وهذا هو أطول من بناء الواقع بقية قانون بلدي. وهناك الآلاف من الملفات من دون أي وثائق لذا أعتقد أنه يقضي معظم وقته معالجتها. هل هناك أي طريقة للحصول عليه لتخطي الملفات من دون أي وثائق؟

وماذا عن الحصول عليها لعملية الوحيدة الملفات التي تم تغييرها؟

Answer 1

ومن وثائق Doxygen:

<اقتباس فقرة>   

وكيف يمكنني استبعاد كافة الدلائل اختبار   من وجهة نظري شجرة الدليل؟

     

وببساطة وضع استبعاد نمط مثل   هذا في ملف التكوين:

     

وEXCLUDE_PATTERNS = <م> / اختبار /

وهكذا، يجب أن تستخدم أنماط استبعاد الملفات. لقد مضى وقت طويل منذ ان كنت تستخدم Doxygen، ولكن أنا لا أتذكر أي خيار لمعالجة الملفات التي تم تغييرها فقط.

Answer 2

ولقد وجدت أن إيقاف SEARCH_INCLUDES الخيار فرقا كبيرا. انها تتطلع من خلال منصة SDK كله، وتشمل مسارات للمترجم الذي لم يتم توثيقها على أي حال، وسوف لا تظهر في الوثائق التي تم إنشاؤها.

Answer 3

وهناك خيارات DOT_NUM_THREADS التي قد تزيد من الأداء على الأجهزة متعددة النواة. للأسف doxygen في حد ذاته هو مجرد مترابطة واحد.

وثمة نهج آخر يتمثل في تنظيم التعليمات البرمجية إلى تشغيل وحدات لكل وحدة مثيل doxygen منفصل وربط العلامات الناتجة معا: <لأ href = "http://www.doxygen.nl/manual/external.html" يختلط = "نوفولو noreferrer"> http://www.doxygen.nl/manual/external.html

Answer 4

وDoxygen هو جيد في إيجاد صلات بين الملفات، سواء تغير أم لا. لكن Doxygen لا يتذكر المعلومات حول الملفات دون تغيير، لذلك يجب معالجة مصدر برنامج كامل في كل مرة.

قد يكون من شأنه حل يتمثل في تنظيم المشروع بحيث أبدا تغيير الملفات تنتمي إلى وحدة واحدة والتي استبعدت من نطاق Doxygen والذي الوثائق هو متاح بالفعل. ثم كان من الممكن أن أقول Doxygen لربط الوثائق التي تم بناؤها حديثا لهذه الوثائق وحدة القائمة.

والذهاب أبعد من ذلك، سيكون من الممكن أيضا لجعل Doxygen تشغيل وحدة من قبل وحدة، وتجهيز وحدات وثائق المستوى الأعلى الذي يربط جميع الوثائق حدة تغير فقط.

Answer 5

وأنا لا أعتقد أن وجود Doxygen تشغيل على دورة ديف العادية هو فكرة جيدة. يعمل لدينا Doxygen بناء كجزء من مسؤولياتنا المستمر الخادم التكامل و.

ومع ذلك، هناك بعض الفوائد من تشغيل doxygen كل بناء للقبض على مستندات في عداد المفقودين. لذلك أود أن تقليم التكوين doxygen لديف يبني إزالة الرسوم البيانية، وحتى وقف التفاح استيراده إلى كسكودي.