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.
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.
| Előző | Tartalom | Következő |
| Az egyes dokumentumokkal kapcsolatos tudnivalók | 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): <freebsd-questions@FreeBSD.org>.
Ha ezzel a dokumentummal kapcsolatban van kérdése,
kérjük erre a címre írjon: <gabor@FreeBSD.org>.