دوكسيجين ج # شمل التعليقات والأدوية لا تولد روابط في إخراج هتمل

Question

لم أتمكن من العثور على أي شيء عن على الشبكة و إم جاهل تماما لدعم شمل تعليق في دوكسيجين.

مشكلتي بسيطة مثل هذا:

/// <see cref="GenericClass{TTypeparam}"/>

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

وأنا أعلم أن ربط الأدوية يعمل في دوكسيجين من صفحات مخصصة باستخدام GenericClass<TTypeParam>.فهل هذا خطأ معروف, أم أنني أفتقد شيئا واضحا?

راجع للشغل.إم باستخدام دوكسيجين 1.8.2

Answer 1

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

Answer 2

دوكسيجين فقط لا يبدو أن لديها وسيلة جيدة للتعامل مع الأدوية في الوقت الراهن (في 1.8.8) - إلا إذا كنت سعيدا لنسيان تنسيق شمل المدعومة من ميكروسوفت القياسية (الذي يستخدم {...} بناء الجملة) والتحول إلى استخدام" جينيركلاس "أو" \المرجع جينيركلاس " (وكلاهما بالطبع شمل غير صالح أن الأدوات البصرية ستوديو لن ترغب).

انظر البق دوكسيجين https://bugzilla.gnome.org/show_bug.cgi?id=738173, https://bugzilla.gnome.org/show_bug.cgi?id=738167 و https://bugzilla.gnome.org/show_bug.cgi?id=704090