Совместимость между Doxygen и DocBlox
Я нахожусь в процессе выбора инструмента API Documentation Generator для проекта в Drupal.
Разработчики Drupal Core используют Doxygen: http://drupal.org/node/1354
Читая их соглашения о форматировании комментариев, мне кажется, что Doxygen и DocBlox используют теги, которые совместимы между ними.
Это предположение верно?
Это означает, что если я создаю свою документацию, неявно следуя документации Doxygen или документации DocBlox, это позволит мне создавать документацию с любым из них.
1 ответ
Решение
К сожалению, DocBlox был разработан независимо от Doxygen, поэтому набор поддерживаемых тегов не одинаков, и, что еще хуже, некоторые теги имеют одно и то же имя, но имеют другое значение / функцию (например, @package и @var).