Имеет ли Objective C структуру документации, похожую на JavaDoc, где документация может быть сгенерирована из исходного кода?
Структуры документации, такие как JavaDoc для Objective C
Ответ 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 для библиотек, которые он устанавливает. Очень удобно.