Instruzioni per compilare la documentazione [1/2]

Con questa email (e la prossima) vi spieghero' cosa dovete installare e 
come dovete procedere per compilare la documentazione....non e' una cosa 
breve, ma non e' nemmeno troppo complesso.

L'unica cosa su cui mi soffermero' poco e' l'aggiornamento dei sorgenti, 
che si trovano in /usr/doc....come per il resto del sistema si possono 
aggiornare tramite cvsup...se non volete scaricare tutte le lingue, 
quello che vi basta sono le directory en_US.ISO8859-1, it_IT.ISO8859-15, 
release e share. Un "refuse" di esempio (da aggiustare un pochino) lo 
trovate in /usr/src/share/examples/cvsup/refuse. Una volta aggiornati i 
sorgenti dal repository ufficiale, potreste voler compilare la 
documentazione italiana cosi' come si trova sul repository dei gufi, che 
usualmente contiene sorgenti sgml piu' aggiornati...questo passo non e' 
obbligatorio, cmq se volete farlo vi consiglio di crearvi uno script di 
questo tipo:

#!/bin/sh
export CVSROOT=:pserver:anonymous:@cvs.gufi.org:/cvs
cvs login
cvs export -r HEAD doc
cp -R doc/* /usr/doc
rm -R doc

che scarica la documentazione e la mette al posto giusto...okkio alla 
dir in cui lo eseguite e all'utente con il quale lo fate ;-)

Passiamo ora all'installazione dei port...l'unico port da installare e' 
textproc/docproj...non siate contenti, questo port ha una trentina di 
dipendenze =) Se provate a installarlo noterete subito che si ferma 
chiedendovi di specificare un parametro, ovvero se volete o meno 
jadetex. Se non vi interessa la documentazione in ps/pdf potete mettere 
JADETEX=no in /etc/make.conf o in /usr/local/etc/pkgtools.conf (se usate 
portupgrade), altrimenti mettete JADETEX=yes e preparatevi a scaricare e 
compilare svariate decine di MB di files. Tutte le dipendenze si 
installano in automatico a parte ghostscript che e' un port interattivo. 
  Il mio consiglio e' di installare *prima* print/ghostscript-gnu con le 
opzioni A4=1 BATCH=1 (che come al solito potete mettere in make.conf 
[*escluso* BATCH=1] o in pkgtools.conf, non staro' piu' a ripeterlo).
A questo punto, a seconda che vogliate o meno i ps/pdf potete procedere 
in due modi: se non li volete, installate il port docproj e avete finito 
(evviva! no vic, tu non rientri in questo caso), se li volete, invece, 
le cose sono un po' piu' complesse (volete la bicicletta? pedalate! vic 
sei in forma?). Anche qui in teoria ci sarebbe un bivio, se volete i pdf 
belli o i pdf brutti...siccome nessuno vuole compilare mezzo mondo per 
avere i pdf brutti (ma in A4, visto che abbiamo compilato ghostscript 
con l'opzione A4), vi descrivo solo come fare per avere i pdf belli 
(ovviamente e' un briciolo piu' laborioso e io sono molto sadico =)). 
Installate il port textproc/sgmlformat con l'opzione WITH_OPENJADE=1 e 
successivamente il docproj con le opzioni WITH_OPENJADE=1 JADETEX=yes. A 
questo punto andate pure a letto e aspettate/sperate che la mattina sia 
di buon auspicio :-) Ma non e' ancora finita (quasi). Per ultima cosa 
dovete fare delle modifiche al file 
/usr/local/share/texmf/web2c/texmf.cnf, in particolare dovete impostare 
i seguenti valori:

hash_extra = 60000
save_size = 10000

Adesso e' proprio tutto....nel prossimo messaggio vi spieghero' come 
utilizzare tutto questo ambaradan per compilare la documentazione :-)

--
Alex Dupre