Почему комментарии XML DOC в заголовке C ++ не генерируют вывод? - PullRequest
1 голос
/ 12 ноября 2010

У меня есть проект C ++, который создает DLL, назовем ее my.dll.Наряду с этим я поставляю заголовок с именем my.h, который содержит объявления функций, экспортированных из my.dll.Исходный код my.dll # включает заголовок my.h.Я добавил комментарии XML DOC к объявлениям функций в my.h и установил ключ / doc в командной строке cl.exe.Во время компиляции один файл * .xdc для каждого файла * .cpp, но ни один из них не содержит комментарии XML DOC, найденные в my.h.

Похоже, ключ / doc на cl.exe обрабатывает только комментарии XML DOCиз файлов c / c ++.Это правда?Если нет, как мне заставить его обрабатывать комментарии XML DOC в заголовочном файле?

1 Ответ

0 голосов
/ 12 ноября 2010

Для документации в коде я настоятельно рекомендую doxygen (использует формат javadoc), а не проприетарный формат xmldoc.

...