تمكين XML التعليقات في C++ في Visual Studio 2010

Question

كيف يمكن تمكين/تحقيق XML تعليقات C++ طرق علاء C# و VB في Visual Studio عام 2010 ؟ يبدو أن هذه الوظيفة لم يتم تمكين/متوفرة بشكل افتراضي.

تستهدف في البداية مدارة C++ المشاريع.

Answer 1

هذا غير مدعوم في C ++ لـ VS2010.

Answer 2

خصائص التكوين -> C/C ++ -> ملفات الإخراج -> إنشاء ملفات وثائق XML.

سيتعين عليك إضافة جميع وثائق XML يدويًا (/// لا تقوم بإنشاء قالب موجز لك). أيضا لا يدعم paramref. http://msdn.microsoft.com/en-us/library/ms173501.aspx

Answer 3

لصناعة السيارات في استكمال وثائق xml بذرة عندما /// كتبته محاولة CppTripleSlash - xml doc تعليق ل c++ تمديد.كما أن لديها بعض الأساسية التحسس لاستكمال علامات xml داخل دوك التعليقات.

Answer 4

أعلم أن هذا هو القديم ، لكن في كل مكان نظرت إليه الجميع يقولون إنه غير مدعوم ، أحتاج إلى أداة طرف ثالث أو ما شابه ، لا يوجد شيء صحيح. ما تحتاج إلى معرفته هو أن وثائق XML مدعومة ومتاحة في Visual Studio 2010 ، وهناك شيئان فقط للتعرف عليه:

1. مستندات / إصدارات سابقة / وثائق Visual Studio / XML / العلامات الموصى بها لتعليقات الوثائق:https://docs.microsoft.com/en-us/previous-versions/visualstudio/visual-studio-2012/ms177227٪28v٪3dvs.90٪29

2. في "خصائص مشروع C ++ / ملفات C / C ++ / إخراج / إنشاء ملفات وثائق XML" تعيين إلى "نعم ( / مستند)"

سيقوم بإنشاء ملف .xdc لكل ملف مصدر يحتوي على تعليقات الوثائق "///" ودمجه في ملف وثائق .xml واحد. والوثائق تعمل بشكل جيد في وقت لاحق في مشاريع أخرى.