Подтвердить что ты не робот

Структуры документации, такие как JavaDoc для Objective C

Имеет ли Objective C структуру документации, похожую на JavaDoc, где документация может быть сгенерирована из исходного кода?

4b9b3361

Ответ 1

Doxygen! Вы можете использовать его для многих языков, включая Objective-c

Ответ 2

Хорошая новость для всех!: D Наконец, после долгого ожидания Apple представила парсерные комментарии для наших проектов. В соответствии с новыми функциями в XCode 5:

Документация по проекту из справочной документации по API-интерфейсам и структурированные комментарии в вашем собственном исходном коде отображаются в быстрой панели справки и в пополнении кодов. Doxygen и HeaderDoc структурированные комментарии поддерживаются форматами.

и из Заметки о выпуске Clang 3.2:

Clang анализирует комментарии и может обнаруживать синтаксические и семантические ошибки в комментариях. По умолчанию эти предупреждения отключены. Pass -Wdocumentation чтобы включить предупреждения о комментариях к документации.

Если вы хотите увидеть пример этой новой функции, я рекомендую вам взглянуть на следующую статью: Документация в Xcode 5

Ответ 3

Doxygen довольно популярен среди разработчиков Obj-C.

Ответ 4

Вы можете взглянуть на HeaderDoc, который представляет собой инфраструктуру документации Apple, похожую на Java.

Ответ 5

Appledoc стал очень популярным., версия 1 была основана на Doxygen, тогда как версия 2 была написана с нуля.

В нем не все функции Doxygen (диаграммы, перечисления, классы С++ и т.д.), но то, что он предлагает, - это красиво отформатированные документы в формате HTML интегрированного формата IDE.

Также интересно отметить следующее:

  • Инструмент CocoaPods включает документацию Appliedoc для библиотек, которые он устанавливает. Очень удобно.