Programma per scrivere su una shared memory.
[gapil.git] / README
1 GaPiL - Istruzioni per la "compilazione"
2 -----
3
4 Dato che il testo e` scritto in LaTeX e` necessario "compilarlo" per
5 poter ottenere un formato stampabile.
6
7 Dato l'uso intensivo di vari pacchetti e le dimensioni del tutto, per
8 poter compilare il testo completo di GaPiL occorre aumentare le
9 risorse che LaTeX alloca per il funzionamento, in particolare deve
10 essere editato il file texmf.cnf (in /etc/texmf, su Debian) settando i
11 seguenti valori:
12
13 hash_extra = 10000
14 pool_size = 250000
15 pool_free = 15000
16 stack_size = 500
17
18 Fatto questo con make si puo` ottenere tutto. 
19
20 A seconda dell'ultima cosa che ho fatto sul CVS si puo` trovare una
21 versione di gapil.tex adattata per generare HTML leggibile, piuttosto
22 che gli ordinari PS e PDF.
23
24 Nel primo caso sono commentate le due righe:
25 %\usepackage{mdwlist}              % scommentare per la stampa (PS e PDF)
26 %\usepackage{boxedminipage}        % scommentare per la stampa (PS e PDF)
27 mentre e` scommentata la riga:
28 \include{compatib}    % commentare per la stampa PS e PDF
29
30 Di norma make genera le figure (in eps e pdf da dia), purche' si sia
31 in X (dia non puo` essere lanciato altrimenti per convertire i .dia in
32 .eps), poi passa alla generazione di HTML con latex2html.
33
34
35
36 Se si vuole generare PDF o PS occorrono (verificato che gapil.tex e`
37 nel formato corretto) i comandi:
38
39 PS:
40 latex gapil
41 dvips gapil
42
43 PDF
44 pdflatex gapil
45
46 (prima si devono generare le figure con make)
47
48 Attenzione: a partire da fine Ottobre 2002, per un motivo che non sono
49 ancora riuscito a capire, viene generato un errore alla fine del file
50 session.tex. Il codice e` corretto, cio` non ostante latex si ferma ed
51 occorre farlo proseguire premendo invio.
52
53 NB per un presunto problema di licenza il pacchetto listings e` stato
54 rimosso da Debian. L'ultima versione dello stesso era stata
55 profondamente modificata e non funzionava. Pertanto non e` detto che
56 sia possibile "compilare" Gapil su una Sid.