Будет ли MS Visual Studio 2008 отображать справку по моим собственным функциям, если я буду использовать для них комментарии в стиле Javadoc? - PullRequest
0 голосов
/ 20 октября 2008

Например, в C # или в документах JavaScript.
Если нет, есть ли смысл использовать Javadoc комментарии в программировании ASP.NET?

Ответы [ 2 ]

4 голосов
/ 20 октября 2008

Я почти уверен, что ответ на этот вопрос - нет, не будет. Почему вы используете комментарии в стиле Javadoc, а не комментарии XML? Комментарии XML будут автоматически отображаться механизмом Intellisense, а также позволят вам создавать внешние документы с помощью таких инструментов, как SandCastle.

1 голос
/ 20 октября 2008

Скотт прав, вы должны использовать собственные XML-комментарии, чтобы получить искомый смысл. Что касается Javascript intellisense, я думаю, вам нужно создать специальный файл .js (вручную или динамически) с комментариями xml для этого, а затем ссылаться на него в своих файлах .js. Большинство библиотек .js содержат эти специальные файлы с комментариями .js, на которые вы можете ссылаться для примера.

...