7. fejezet - A dokumentáció előállításának folyamata
Vissza |  | Előre

## 7. fejezet - A dokumentáció előállításának folyamata

Ebben a fejezetben szeretnénk pontosan tisztázni hogyan szerveződik a dokumentáció előállításának folyamata és hogyan tudunk ebbe beavatkozni.

A fejezet elolvasása során megismerjük:

- az SGML eszközeiről szóló fejezetben említetteken túl a FreeBSD Dokumentációs Projekt keretein belül készített dokumentáció különböző változatainak előállításához mire van még szükségünk;

- a dokumentumokhoz tartozó `Makefile` állományokban szereplő `make` utasításokat, valamint a hivatkozott `doc.project.mk` vázlatos felépítését;

- további `make` változókon és célokon keresztül miként tudjuk testreszabni a dokumentáció különböző változatainak előállítási folyamatát.

## 7.1. A FreeBSD dokumentáció előállításának eszközei

Munkánk folyamán az itt felsorolt eszközök állnak rendelkezésünkre. Használjuk ki az általuk nyújtott lehetőségeket, amennyire csak tudjuk.

- Az elsődleges eszköz maga a `make` parancs, pontosabban a Berkeley Make.

- Csomagokat a FreeBSD alaprendszerében megtalálható `pkg_create` programmal tudunk készíteni. Ha nem FreeBSD alatt dolgozunk, akkor vagy csomagok nélkül kell dolgoznunk, vagy magunknak kell ezeket elkészítenünk.

- A `gzip` segítségével lehet az előállított dokumentumok tömörített változatát elkészíteni. Emellett még a `bzip2` és `zip` típusú tömörítés is támogatott. A `tar` programot is támogatjuk, a csomagok készítéséhez kell.

- A dokumentáció telepítésének elfogadott eszköze az `install` program. Természetesen léteznek egyéb megoldások is.

### Megjegyzés:

Nem valószínű, hogy ez az utolsó két eszközt ne lenne elérhető a rendszerünkön, csupán a teljesség kedvéért említettük meg ezeket.

Vissza |  | Előre
6.3. Az egyes dokumentumokkal kapcsolatos tudnivalók | Főoldal | 7.2. A dokumentációt tároló könyvtárban található `Makefile` állományok

Ha kérdése van a FreeBSD-vel kapcsolatban, a következő címre írhat (angolul): <questions@FreeBSD.org>.
Ha ezzel a dokumentummal kapcsolatban van kérdése, kérjük erre a címre írjon: <gabor@FreeBSD.org>.