XML-комментарии стиля C# в Delphi 2010
2010 Delphi имеет XML-комментарии Стиля C#, которые обнаруживаются при парении над вызовом метода?
/// <summary>
/// My comment here
/// </summary>
2 ответа
Я только что попробовал это в D2007, и он работает. Я поместил ваш тестовый комментарий над объявлением метода (внутри объявления класса) и перестроил. Когда вы наведете курсор на вызов этого метода, вы увидите «Мой комментарий здесь» во всплывающей подсказке.
Чтобы это работало, у вас должна быть включена функция оценки HTML. См. Параметры -> Параметры редактора -> Анализ кода -> Описание символа (переведено из немецкой IDE).
Это действительно работает - в Delphi 2007 и 2009 есть проблемы с этим - вы должны иметь ключ типа перед каждым классом, или он выбирает только первый набор документации (не знаю почему), и если вы нажмете опцию 'Build XML documentation', он, кажется, теряется при компиляции большого количества модулей и сдается - я надеюсь, что это будет исправлено в Delphi 2010.
Тем не менее, встроенная документация лучше, чем отсутствие документации вообще!
Эта ссылка на Embarcadero - единственное, что я смог найти, хотя я думаю, что в Architect и Enterprise версиях Delphi есть утилиты для создания внешней документации.