включение комментариев XML в C ++ в Visual Studio 2010

Question

Как можно включить / получить комментарии XML для методов C ++, таких как C # и VB, в Visual Studio 2010? Похоже, эта функция не включена / не доступна по умолчанию.

Ориентация на изначально управляемые проекты C ++.

Answer 1

Свойства конфигурации -> C / C ++ -> Выходные файлы -> Создать файлы документации XML.

Вам нужно будет вручную добавить всю вашу документацию xml (/// не создает автоматически шаблон сводки для вас). Также не поддерживает paramref. http://msdn.microsoft.com/en-us/library/ms173501.aspx

Answer 2

Чтобы автоматически заполнить заглушки документации XML при наборе ///, попробуйте это расширение.В нем также есть базовый смысл для заполнения тегов xml внутри комментариев к документу.

Answer 3

Я знаю, что это старый, но везде, куда бы я ни посмотрел, все говорят, что НЕ ПОДДЕРЖИВАЕТСЯ, нуждаются в стороннем инструменте или подобном, ни один из которых не соответствует действительности Вам нужно знать, что документация XML поддерживается и доступна в Visual Studio 2010, и о ней нужно знать только две вещи:

1. Документы / Предыдущие версии / Visual Studio / Документация XML / Рекомендуемые теги для документации Комментарии: https://docs.microsoft.com/en-us/previous-versions/visualstudio/visual-studio-2012/ms177227%28v%3dvs.90%29

2. В разделе «Свойства проекта C ++ / C / C ++ / Выходные файлы / Создать файлы документации XML» установлено значение «Да (/ doc)»

Он сгенерирует файл .xdc для каждого исходного файла, содержащий комментарии к документации "///", и объединит его в один файл документации .xml. И документация работает отлично позже в других проектах.

Answer 4

Это не поддерживается в C ++ для VS2010.