Почему/документация (Doxygen) удалена из msdn?

Question

Мы используем TFS 2015 по существу в нашей методологии sd. Сделав это, мы хотели бы создать нашу сборку в TFS, используя шаги Visual Studio Build. При этом мы хотели бы вставить шаг Documentation (Doxygen) в поток сборки, но каждый раз, когда мы включали этот шаг, сборка не удалась.

Я пытался получить ответы на вопрос, были ли они параметризованы неправильно или что, поэтому я выкопал интернет. После некоторых исследований я пришел на этот сайт: https://www.visualstudio.com/en-us/docs/build/define/build На этом сайте я больше не вижу документацию (Doxygen), хотя я видел ее раньше. Последнее обновление на этой странице было 9/7/2016.

Наш TFS 2015 поддерживается в актуальном состоянии, но по-прежнему имеет шаг Doxygen.

Мой вопрос: был ли Doxygen Исключен из TFS каким-то образом, или это будет? Какие еще альтернативы нам нужно для создания документации с помощью TFS Build?

Спасибо заранее, Collapo

Answer 1

Там никогда не было официальной поддержки от Microsoft для Doxygen?

http://www.stack.nl/~dimitri/doxygen/helpers.html

Прокрутка вниз:

Visual Studio

Если вы используете Visual Studio .NET взглянуть на набор Стива Кинга расширений. Грег Энгельстад написал скрипт perl для анализа файла Visual Studio Studio .NET (.sln) и запускает doxygen для каждого отдельного проекта , содержащегося в нем.

Джейсон Уильямс написал надстройку для Visual Studio 2005 , который способен автоматически генерировать Doxygen (или DocXml) стиль комментариев от большинства элементов кода (файл, пространство имен, класс, структура, перечисление, функция, и т.д). Он анализирует C, C++, C# и Java-код для получения полностью сформированных комментариев 0xydoxygen и может обновлять эти комментарии, если элемент кода изменен и сложить описания, чтобы сохранить их в порядке. Он использует набор правил, редактируемых пользователем, для автоматического описания элементов, параметров и кодов возврата , минимизируя при этом усилия при генерации комментариев к документу.

jgallardo также написал Addin для Visual Studio, что облегчает просмотр документации, созданной doxygen, .

Addin для Visual Studio 2005 под названием DoxyComment был создан Troels Gram. Он предназначен для того, чтобы помочь вам вставить контекстные чувствительные блоки комментариев в исходные файлы C/C++. DoxyComment также поставляется с шаблоном xslt, который позволяет создавать документацию, такую ​​как библиотека MSDN.

Если вы используете Microsoft Developer Studio 6.0, надстройка называется DoxBar доступен, который может быть использован для запуска Doxygen внутри Developer Studio и поиска с помощью сгенерированных файлов справки HTML. Примечание: у меня нет времени на то, чтобы больше поддерживать DoxBar, поэтому Я перевел DoxBar в sourceforge.Olivier Sannier представил номер усовершенствований DoxBar. Если вы тоже хотите присоединиться к команде разработчиков , пожалуйста, зарегистрируйтесь как пользователь в sourceforge и напишите мне ваш адрес пользователя .

Bernhard Nowara написал редактор профилей, который представляет собой инструмент для doxywizard, предназначенный для Windows, как . Он также создал расширенную версию DoxBar, которая включает в себя его редактор и некоторые макросы для Visual Studio , чтобы облегчить подготовку исходного кода для doxygen. Эти измененные были объединены в более позднюю версию doxygen от Olivier Sannier.

FeinSoftware выпустила средство разработки для Microsoft Visual Studio .NET (Visual C++) под названием CommentMaker, который создает настраиваемый заголовок функции, которые разработчики могут приспособиться к большинству конкретных требований к документации. По умолчанию он генерирует doxygen совместимых комментариев.

Answer 2

Документация (Doxygen) - это расширение, предоставляемое сторонним лицом, оно официально не поддерживается Microsoft.

И это известная проблема, что она не работает должным образом с сервером на сервере TFS2015. Подробнее см. По этой ссылке: Documentation (Doxygen).

Известные проблемы

• Мы слышали о расширение не работает должным образом с 2015 года сервер TFS (OnPrem).
• Центр документации не загружается в Internet Explorer/Microsoft Edge. (Пожалуйста, используйте Google Chrome на данный момент)