C# Стиль XML Комментарии в Delphi 2010

Question

Есть ли в Delphi 2010 комментарии XML в стиле C#, которые появляются при наведении указателя на вызов метода?

/// <summary> 
/// My comment here 
/// </summary> 

Answer 1

Я просто попробовал его в D2007, и он работает. Я поставил ваш тестовый комментарий выше объявления метода (внутри декларации класса) и перестроен. Когда вы теперь наводите вызов на этот метод, вы увидите «Мой комментарий здесь» внутри всплывающей подсказки.

Для этого вам необходимо, чтобы эта оценка HTML была включена. См. Параметры -> Параметры редактора -> Code Insight -> Описание символа (переведено с немецкой IDE).

Answer 2

Он работает - в Delphi 2007 и 2009 годах есть проблемы с ним - у вас должен быть тип keywork перед каждым классом или он выбирает только первый набор документации (не знаю почему), и если вы нажмете 'Build XML documentation', кажется, что он потерялся при компиляции множества единиц и сдался - я надеюсь, что это исправлено в Delphi 2010.

Сказав, что документация встроена лучше, чем вообще никакой документации!

This link для Embarcadero - единственное, что я могу найти, хотя я думаю, что в версиях Delphi Architect и Enterprise есть утилиты для создания внешней документации.

Answer 3

Существует мало документации для этого, хотя есть небольшой article на Delphi Wiki. У Марко Канту также есть несколько коротких сообщений в блогах here и here.