Задача -Генераторы документации C :HeaderDoc, Doxygen и AppleDoc

Мне нужно внедрить решение для создания документации для своего рабочего места, и я сузил его до трех, упомянутых в заголовке. Мне удалось найти очень мало информации относительно формализованных сравнений между этими решениями, и я надеюсь, что те из вас, у кого есть опыт работы с одним или несколькими из вышеперечисленных, смогут оценить :

. Вот то, что мне удалось выяснить. почерпнуть из моего начального прохода:

HeaderDoc Pros :Соответствие существующей документации Apple, совместимость с созданием наборов документации Apple
Минусы HeaderDoc :Трудно изменить поведение, над проектом активно не работают, многие отказались от него (, что означает, что должен быть какой-то недостаток, хотя я не могу его количественно оценить ).

Доксиген Профи :Сообщество активной поддержки b/c, широко используемая база, широкие возможности настройки, большинство типов вывода (, такие как латекс и т. д.)
Doxygen Cons :Требуется работа, чтобы он выглядел и работал в соответствии с документами Apple, совместимость с наборами документов Apple не так проста

AppleDoc Pros :Выглядит в соответствии с существующей документацией Apple, совместимость с созданием наборов документации Apple,
Минусы AppleDoc :Проблема с документацией typedefs, enums и функций,активно разрабатывается

Это звучит правильно? Наше желаемое решение будет иметь:

  • согласованный внешний вид с целью яблок -ссылку на класс c
  • возможность для опции -щелкните, чтобы получить ссылку на документацию из Xcode, а затем ссылку на документ (просто как классы Apple)
  • Интеллектуальная обработка категорий, расширений и т. п. (даже настраиваемые категории классов Apple)
  • Возможность создавать собственные справочные страницы (как эта страница :Загрузка… которые могут включать изображения, и легко связываться с созданными ссылками на классы, например, как ссылка на класс Apple UIViewController ссылается на связанную страницу.
  • Простые в использовании команды командной строки, которые можно интегрировать в скрипты сборки.
  • Изящная обработка очень большой базы кода.

Основываясь на всей вышеизложенной информации, одно из приведенных выше решений явно лучше других? Любые предложения или информация для добавления будут чрезвычайно оценены.

74
задан Chris 11 April 2012 в 20:00
поделиться