Главная цель этой главы заключается в четком описании того, как организован процесс построения документации, а также как внести изменения в этот процесс.
После чтения этой главы вы должны:
Знать, что нужно для построения документации FDP, кроме того, что описано в главе об инструментах для работы с SGML.
Уметь читать и понимать make-инструкции, которые присутствуют в файлах Makefile каждого документа, а также иметь представление о включаемых операциях из doc.project.mk.
Уметь настраивать процесс построения при помощи make-переменных и целей make.
Вот ваши инструменты. Используйте их любым доступным вам способом.
Основным инструментом построения, который вам понадобится, является make, и конкретно Berkeley Make.
Построение пакаджа выполняется утилитой FreeBSD pkg_create. Если вы не используете FreeBSD, вы либо обходитесь без пакаджей, либо компилируете исходные тексты самостоятельно.
gzip нужен для создания компрессированных версий документа. Компрессия bzip2 и архивы zip также поддерживаются. tar поддерживается, но он требуется при построении пакаджа.
install является методом, используемым по умолчанию для установки документации. Однако есть и альтернативы.
Замечание: Сомнительно, что вы не сможете найти последние утилиты, они отмечены для полноты.
| Пред. | Начало | След. |
| Информация, специфичная для конкретных документов | Понимание make-файлов в дереве документации |
Этот, и другие документы, могут быть скачаны с ftp://ftp.FreeBSD.org/pub/FreeBSD/doc/.
По вопросам, связанным с FreeBSD, прочитайте документацию прежде чем писать в <questions@FreeBSD.org>.
По вопросам, связанным с этой документацией, пишите <doc@FreeBSD.org>.
По вопросам, связанным с русским переводом документации, пишите в рассылку <frdp@FreeBSD.org.ua>.
Информация по подписке на эту рассылку находится на сайте проекта перевода.