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.