Ответ 1
Я явно не Дейв ДеЛонг, но я бы использовал appledoc, это довольно чертовски классно!
Страница страницы разработчика:
appledoc - это инструмент командной строки, который помогает разработчикам Objective-C генерировать Документация на исходный код, подобный Apple из форматированного исходного кода Комментарии. Он предназначен для читаемые комментарии к исходному коду как возможно для ввода и использования комментарии, а также окружающий источник код для создания визуально привлекательных документация в виде HTML как а также полностью проиндексированы и доступны для просмотра Набор документации Xcode. Несмотря на то что существует несколько инструментов, которые могут создать документацию HTML для Objective-C, все знают обо мне не соответствуют минимальному цели, описанные ниже.
Человеческий читаемый исходный код. appledoc предназначен для сохранения источника комментарии кодов как можно более читаемые даже в редакторе исходного кода.
Перекрестные ссылки на объекты и члены. Создание перекрестных ссылок на классов, категорий или протоколов простой и автоматизированный насколько это возможно.
Яблочный исходный код HTML-документация Создание привлекательных Документация HTML с тем же стилем как Apple.
Создание набора документации Xcode Генерировать и устанавливать полностью индексированные и доступных для просмотра наборов документации Xcode. Набор документации также может быть автоматически устанавливается в Xcode.
Одиночный инструмент от кода sorce до doc set Один инструмент для генерации генерации от синтаксического анализа исходного кода до установка набора документации
Легко настраиваемый вывод appledoc дает вам много команд чтобы вы могли параметризовать вывод. Если этого недостаточно, вы можете изменить любой или весь шаблон файлов в соответствии с вашими потребностями.
100% Objective-C реализация. Все appledoc написано в Objective-C, поэтому вы можете легко изменить он использует знакомый язык и инструменты. Это также упрощает отладку и эффективны.