Primer do Projeto de Documentação do FreeBSD para novos colaboradores
Anterior |  | Próxima

# Capítulo 7 O processo de construção da documentação

A principal finalidade desse capítulo é explicar claramente como o processo de criação da documentação é organizado, e como fazer modificações a este processo.

Depois de finalizar a leitura deste capítulo você deverá:

- Saber o que você precisa para compilar a documentação mantida pelo FDP, em adição ao que foi mencionado no capítulo Ferramentas SGML.

- Ser capaz de ler e entender as instruções do make que estão presentes em cada documento `Makefile`, assim como ter uma visão geral do `doc.project.mk`.

- Ser capaz de customizar o processo de compilação usando variáveis e alvos do make.

# 7.1 Ferramentas para construção da documentação do FreeBSD

Aqui estão suas ferramentas. Use-as de todas as formas que puder.

- A primeira ferramenta que você precisará é o make, mais especificamente o Berkeley Make.

- A construção de pacotes no FreeBSD é executada pelo pkg_create. Se você não está utilizando o FreeBSD, você terá que viver sem o uso de pacotes, ou então terá que compilar o código fonte você mesmo.

- O gzip é necessário para criar versões compactadas do documento. O compressor bzip2 e os arquivos zip também são suportados. O tar é suportado, e a construção de pacotes necessita dele.

- O install é o método padrão para instalar a documentação. Entretanto, existem alternativas.

> Nota: É improvável que você tenha qualquer problema em localizar esses dois últimos, eles estão sendo mencionados apenas para que a listagem fique completa.

Anterior | Principal | Próxima
Informação Específica do Documento |  | Entendendo `Makefile`s na árvore da documentação

Este, e outros documentos, podem ser obtidos em ftp://ftp.FreeBSD.org/pub/FreeBSD/doc/.

Para perguntas sobre FreeBSD, leia a documentação antes de contatar <questions@FreeBSD.org>.
Para perguntas sobre esta documentação, envie e-mail para <doc@FreeBSD.org>.