XML-комментарии в стиле C # в Delphi 2010 - PullRequest
7 голосов
/ 09 марта 2010

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

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

Ответы [ 3 ]

8 голосов
/ 09 марта 2010

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

У вас должна быть включена эта HTML-оценка, чтобы это работало. См. Параметры -> Параметры редактора -> Понимание кода -> Описание символов (в переводе с немецкой IDE).

4 голосов
/ 10 марта 2010

Это работает - в Delphi 2007 и 2009 есть проблемы с ним - вы должны иметь тип клавиш перед каждым классом, или он выбирает только первый набор документации (не знаю почему), и если вы нажимаете Опция «Сборка XML документации», кажется, теряется при компиляции большого количества модулей и сдается - надеюсь, это исправлено в Delphi 2010.

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

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

0 голосов
/ 12 августа 2011

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

...