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.
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.
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.
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>.