HeaderDoc - HeaderDoc

HeaderDoc
Разработчики)Apple Inc.
изначальный выпуск13 сентября 2000 г.
Стабильный выпуск
8.9 / 8 июня 2009 г.
Написано вPerl, C (помощники)
Операционная системаMac OS X, UNIX, Linux
ТипГенератор документации
ЛицензияЛицензия Apple Public Source License 2.0
Интернет сайтразработчик.яблоко.com/Открытый исходный код/инструменты/ headerdoc.html

HeaderDoc это генератор документации разработан и поддерживается Apple Inc. Используя специально закомментированные файлы исходного кода в качестве входных данных, HeaderDoc создает документацию для кода в HTML или же XML формат. Синтаксис тегов комментариев HeaderDoc во многом аналогичен и, начиная с версии 8 HeaderDoc, поддерживает Javadoc теги. HeaderDoc 8.7 и новее также обеспечивает частичную поддержку многих Doxygen теги (только форма @ и должны соответствовать правилам упорядочивания тегов HeaderDoc). Проект Apple HeaderDoc свободный, Открытый исходный код программное обеспечение, распространяемое в рамках Лицензия Apple Public Source License.

Поддерживаемые языки обычного текста

Набор инструментов HeaderDoc состоит из основной утилиты headerdoc2html и gatherheaderdoc. Инструмент headerdoc2html создает каталог либо HTML (или по желанию XML ) файлы из указанных закомментированных исходных файлов. После этого можно запустить утилиту gatherheaderdoc для создания оглавление файл для документации. Наконец, утилита resolveLinks может использоваться для разрешения перекрестных ссылок между несколькими коллекциями документации.

Apple Xcode Среда разработки содержит функции, предназначенные для помощи в процессе создания документации с использованием синтаксиса и инструментов HeaderDoc.

Дополнительные возможности

HeaderDoc имеет следующие основные функции:

  • Предварительная обработка C, позволяющая выбранным пользователем макросам #define изменять содержимое и позволяющая пользователю передавать флаги командной строки для игнорирования частей ввода.
  • Раскраска синтаксиса с пользовательскими стилями.
  • Целевые страницы на основе шаблонов для индексов.
  • Кроссплатформенность (написана в основном на Perl).

В комплект HeaderDoc также входит несколько инструментов, которые можно использовать независимо:

  • MPGL - набор инструментов, предназначенных для упрощения создания справочных страниц UNIX с использованием облегченного синтаксиса XML, состоящего из подмножества XHTML плюс тегов разделов, тегов параметров и т. Д. HeaderDoc также предоставляет инструмент связывания, который помогает создавать справочные страницы из комментариев заголовков для функций через Режим вывода XML HeaderDoc.
  • resolveLinks —Инструмент, позволяющий быстро перенастроить веб-сайт при перемещении контента на другой адрес с помощью встроенных якорей и запросов ссылки.
  • filtermacros.pl - инструмент, который можно использовать для фильтрации разделов заголовков на основе макросов препроцессора C. В настоящее время это доступно только при загрузке архива с исходным кодом. Начиная с HeaderDoc 8.9, эта функциональность встроена в сам инструмент headerdoc2html.

Смотрите также

внешняя ссылка