Мне нужно внедрить решение для создания документации для своего рабочего места, и я сузил его до трех, упомянутых в заголовке. Мне удалось найти очень мало информации относительно формализованных сравнений между этими решениями, и я надеюсь, что те из вас, у кого есть опыт работы с одним или несколькими из вышеперечисленных, смогут оценить :
. Вот то, что мне удалось выяснить. почерпнуть из моего начального прохода:
HeaderDoc Pros :Соответствие существующей документации Apple, совместимость с созданием наборов документации Apple
Минусы HeaderDoc :Трудно изменить поведение, над проектом активно не работают, многие отказались от него (, что означает, что должен быть какой-то недостаток, хотя я не могу его количественно оценить ).
Доксиген Профи :Сообщество активной поддержки b/c, широко используемая база, широкие возможности настройки, большинство типов вывода (, такие как латекс и т. д.)
Doxygen Cons :Требуется работа, чтобы он выглядел и работал в соответствии с документами Apple, совместимость с наборами документов Apple не так проста
AppleDoc Pros :Выглядит в соответствии с существующей документацией Apple, совместимость с созданием наборов документации Apple,
Минусы AppleDoc :Проблема с документацией typedefs, enums и функций,активно разрабатывается
Это звучит правильно? Наше желаемое решение будет иметь:
Основываясь на всей вышеизложенной информации, одно из приведенных выше решений явно лучше других? Любые предложения или информация для добавления будут чрезвычайно оценены.