Совместимость между Doxygen и DocBlox - PullRequest
1 голос
/ 23 февраля 2012

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

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

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

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

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

1 Ответ

2 голосов
/ 23 февраля 2012

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

...