Совместимость между Doxygen и DocBlox

Я нахожусь в процессе выбора инструмента API Documentation Generator для проекта в Drupal.

Разработчики Drupal Core используют Doxygen: http://drupal.org/node/1354

Читая их соглашения о форматировании комментариев, мне кажется, что Doxygen и DocBlox используют теги, которые совместимы между ними.

Это предположение верно?

Это означает, что если я создаю свою документацию, неявно следуя документации Doxygen или документации DocBlox, это позволит мне создавать документацию с любым из них.

1 ответ

Решение

К сожалению, DocBlox был разработан независимо от Doxygen, поэтому набор поддерживаемых тегов не одинаков, и, что еще хуже, некоторые теги имеют одно и то же имя, но имеют другое значение / функцию (например, @package и @var).

Другие вопросы по тегам