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

Question

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

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

Answer 1

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

Answer 2

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

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

Answer 3

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

Answer 4

Я знаю, что это старая, но везде я смотрел, все говорю, не поддерживается, нужен 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. И документация работает нормально позже в других проектах.