System budowania dokumentacji wzorowałem na phpdoc używanym do tworzenia manuala PHP. Różnica jest taka, że tam skrypt budujący napisany jest w bashu, co wymusza użycie Linuxa. Ja tymczasem na co dzień robię pod Windowsem, dlatego swą wersję napisałem w PHP, a całość odpala się z linii komend: php -f build.php pl html-chunk. Zadaniem skryptu PHP jest połączenie porozrzucanej w setkach plików dokumentacji w jeden wielki dokument, odpalenie procesora XSL (tu: xsltproc) do przerobienia go na HTML, pokolrowanie składni w przykładach oraz posprzątanie śmieci po procesie budowania. Całość jest bardzo przydatna, bowiem ręczne wywoływanie każdego polecenia do najprzyjemniejszych nie należy. A tak podaję język dokumentacji i jej rodzaj (tu: HTML, wiele stron), a skrypcik automatycznie dobiera mi arkusz stylów, konfiguruje parser i w ogóle.
Jeśli chodzi o samą strukturę dokumentacji, to źle zrobiłem, opisując w sekcji "Dla programistów" metody i pola przy użyciu <refentry>. XSL generuje przez to beznadziejne menu, a ja muszę przerabiać ponad 60 plików...
