<?xml version="1.0"? encoding="ISO-8859-1"?>
<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd"
[
<!ENTITY kernel-compile "
<note>
<title>Aiuto per compilare il Kernel</title>
<para>Per istruzioni relative a distribuzioni diverse da Debian si veda l'Appendice
	<quote><xref linkend='nodebkernel' /></quote>.</para>

<para>Per ulteriori istruzioni su come compilare il kernel nel Modo Debian
si legga<ulink
url='http://newbiedoc.sourceforge.net/system/kernel-pkg.html'>Creazione di un kernel personalizzato
con il sistema kernel-package di Debian</ulink></para>
</note>
">

<!ENTITY resources-software "
<tip>
	<title>Scaricare il software</title>
	<para>
	  Per ulteriori informazioni sul software per ACPI, si veda 
	  <xref linkend='software' />.
	</para>
</tip>
">

<!ENTITY kernel-version "<replaceable>&lt;version&gt;</replaceable>">
<!ENTITY kernel-name "<replaceable>&lt;date&gt;</replaceable>">

]>

<article id="index" lang="it">
<articleinfo>
<title>ACPI: Advanced Configuration and Power Interface</title>

<authorgroup>
<author>
      <firstname>Emma Jane</firstname>
      <surname>Hogbin</surname>
      <authorblurb><para>Emma Jane Hogbin &egrave; una sviluppatrice di Toronto con
	  credenziali open-source</para></authorblurb>
	<affiliation>
	<orgname>
		<ulink url="http://www.xtrinsic.com">xtrinsic</ulink>
	</orgname>
	<address>
	   <email>emmajane@xtrinsic.com</email>
	</address>
    </affiliation>
</author>

<othercredit>
      <firstname>Erich</firstname>
      <surname>Schubert</surname>
      <contrib>Autore della sezione su DSDT.</contrib>
</othercredit>
</authorgroup>

<abstract>
	<para>Guida all'applicazione di una patch al kernel per il supporto ACPI.</para>
	<para>Traduzione a cura di Giuseppe Briotti <email>g.briotti (at) mclink.it</email>.
	Revisione a cura di Amelia De Vivo <email>devivo (at) unibas.it>/email></email>.</para>
</abstract>

<revhistory>
	<revision>
	<revnumber>v1.5.1</revnumber>
	<date>2004-07-15</date>
	<authorinitials>ejh</authorinitials>
	<revremark>Incluso un collegamento alla traduzione Francese di questo documento.</revremark>
	</revision>
	<revision>
	<revnumber>v1.5</revnumber>
	<date>2004-05-21</date>
	<authorinitials>ejh</authorinitials>
	<revremark>Aggiornamenti minori per il kernel 2.6.6 e correzioni riguardanti
	quali kernel hanno bisogno di patch.</revremark>
	</revision>
	<revision>
	<revnumber>v1.4</revnumber>
	<date>2004-05-12</date>
	<authorinitials>ejh</authorinitials>
	<revremark>Prime riflessioni sul kernel 2.6.5; incluse informazioni
	sulle applicazioni per il controllo delle batterie che causano problemi al lockup
	del touchpad.</revremark>
	</revision>

	<!--
	<revision>
	<revnumber>v1.3</revnumber>
	<date>2003-07-15</date>
	<revremark>Creata una nuova categoria di risorse per articoli riguardanti
	il funzionamento di ACPI (articoli ACPI).</revremark>
	</revision>
	<revision>
	<revnumber>v1.2</revnumber>
	<date>2003-07-08</date>
	<revremark>Aggiunto l'abstract.</revremark>
	</revision>
	<revision>
	<revnumber>v1.1</revnumber>
	<date>2003-07-03</date>
	<revremark>Inseriti aggiornamenti per il kernel 2.4.21, l'ultima versione stabile
	al momento.</revremark>
	</revision>
	<revision>
	<revnumber>v1.0</revnumber>
	<date>2003-07-01</date>
	<revremark>Stesura iniziale, revisionata da LDP</revremark>
	</revision>
	<revision>
	<revnumber>v0.2</revnumber>
	<date>2003-06-12</date>
	</revision>
	-->
</revhistory>
</articleinfo>

<sect1 id="about">
<title>Questo documento</title>
<para>Quando inizialmente ho cominciato il passaggio da APM a ACPI, non avevo realizzato che
il kernel aveva bisogno di una patch. Il mio problema (folle ammiratore) fu risolto solo con
il passaggio alla versione 2.4.20 (kernel distribuito da Debian con una prima patch di
<ulink url="http://acpi.sourceforge.net">acpi.sourceforge.net</ulink>).
Sfortunatamente, dopo il primo aggiornamento, non mi &egrave stato possibile
arrestare il computer senza utilizzare l'interruttore dell'alimentazione per spegnerlo.
&Egrave; stato solo dopo che ho realizzato di avere una patch ACPI vecchia
ed inefficace. Questo HOWTO &egrave; stato scritto per riassumere il processo di installazione
da me utilizzato, con la speranza di aiutare altri che hanno avuto difficolt&agrave;  a reperire
informazioni sull'ACPI. Si noti:
il corpo principale del documento mostra <ulink url="http://www.debian.org">Il Modo Debian</ulink>
di risolvere il problema. Vi sono anche informazioni generiche nella sezione
<xref linkend="nodebkernel" /> per quelli che preferiscono... il modo generico.</para>
</sect1>

<sect1 id="copyright">
<title>Copyright e Licenza</title>
<blockquote><para>
      Copyright (c) 2003, 2004 Emma Jane Hogbin.</para>
      <para>Permission is granted to copy, distribute and/or modify this
      document under the terms of the GNU Free Documentation License, Version
      1.1 or any later version published by the Free Software Foundation;
      with no Invariant Sections, no Front-Cover Texts, and with no Back-Cover
      Texts.
      A copy of the license is included in <xref linkend="gfdl"/>.
</para></blockquote>

     <para>(NdT. di seguito &egrave; riportata la traduzione del paragrafo precedente, con
     l'avvertenza che ha valore legale solo il testo originale in inglese)
     </para>

      <blockquote><para>
      Copyright (c) 2003, 2004 Emma Jane Hogbin.</para>
      <para>&Egrave; concesso il permesso di copiare, distribuire e/o modificare questo documento
      nei termini della licenza GNU sulla libera documentazione, Versione 1.1
      o qualunque versione successiva pubblicata dalla Free Software Foundation;
      senza le clausole sulle Sezioni immodificabili, sulla Prima di copertina e sull'Ultima
      di copertina. Una copia della licenza &egrave; riportata in <xref linkend="gfdl"/>.
     </para>
    </blockquote>

</sect1>

<sect1 id="translations">
<title>Traduzioni</title>
<para>Questo documento &egrave; anche disponibile nelle seguenti lingue:</para>

<itemizedlist>
<listitem>
<para>La versione 1.2 in inglese &egrave; tradotta in: <ulink url="http://www.traduc.org/docs/HOWTO/lecture/ACPI-HOWTO.html">Francese</ulink>. Merci a  Guillaume Lelarge et Vanessa Conchodon pour le traduction!</para>
</listitem>
</itemizedlist>

</sect1>

<sect1 id="aboutacpi">
<title>Sull'ACPI</title>

<para>Nel mondo della gestione dell'alimentazione ACPI &egrave; relativamente recente.
Fu rilasciata la prima volta nel 1996 da
Compaq/Hewlett-Packard, Intel, Microsoft, Phoenix e Toshiba. Questi sviluppatori
ambivano a rimpiazzare il precedente standard industriale per la gestione
dell'alimentazione. Il loro sito <ulink url="http://www.acpi.info">ACPI.info</ulink>
contiene le specifiche ufficiali, una lista delle compagnie che supportano ACPI
ed un certo numero di altre cose interessanti. Non si tratta di letture necessarie, ma
possono essere di qualche interesse per i curiosi morbosi.</para>

<para>ACPI consente il controllo della gestione dell'alimentazione dall'interno
del sistema operativo. Il precendente standard industriale per la gestione dell'alimentazione,
l'Advanced Power Management (APM), &egrave; controllato a livello di BIOS. L'APM viene attivato
quando il sistema rimane inattivo: pi&ugrave; a lungo il sistema rimane inattivo, meno energia
consuma (ad es. si passa dall'attivazione del salvaschermo alla modalit&agrave;  "sleep" fino alla "suspend").
In APM, il sistema operativo non ha conoscenza di quando il sistema cambia il proprio stato di
alimentazione.</para>

<para>L'ACPI, tipicamente, pu&ograve; essere configurato dall'interno del sistema operativo.
In questo &egrave; diverso dall'APM, dove la configurazione spesso richiede il riavvio del computer e
l'accesso alle schermate di configurazione del BIOS per l'impostazione dei parametri.</para>

<para>ACPI ha diversi componenti software:</para>
<itemizedlist>
	<listitem><para>un sottosistema che controlla gli stati e le funzioni dell'hardware
	che precedentemente potevano essere nella configurazione del BIOS</para>

	<para>Questi stati includono:</para>
	<itemizedlist>
		<listitem><para>controllo termico</para></listitem>
		<listitem><para>configurazione della scheda madre</para></listitem>
		<listitem><para>stati dell'alimentazione (sleep, suspend)</para></listitem>
	</itemizedlist>
	</listitem>

	<listitem><para>un gestore delle politiche, cio&egrave; un software che si interfaccia col
	sistema operativo e consente all'utente di agire sulle politiche del sistema</para></listitem>

	<listitem><para>l'ACPI contiene anche driver che controllano periferiche quali
	le batterie di un portatile, SMBus (percorso di comunicazione/trasmissione) e EC (controller
	integrato).</para></listitem>
</itemizedlist>

<para>Se si desiderano maggiori informazioni sulla gestione dell'alimentazione nei portatili, si guardino le
risorse disponibili su <ulink url="http://www.tuxmobil.org">tuxmobil.org</ulink>.
Specificatamente: <ulink url="http://tuxmobil.org/apm_linux.html">Power Management with Linux - APM, ACPI, PMU</ulink> e la sezione <ulink
url="http://tuxmobil.org/Mobile-Guide.db/mobile-guide-p2c1-hardware-in-detail.html">Hardware in Detail</ulink>
della <ulink url="http://tuxmobil.org/Mobile-Guide.db/Mobile-Guide.html">Linux Mobile Guide</ulink>.</para>
</sect1>

<sect1 id="apmtoacpi">
<title>Perch&eacute; cambiare?</title>
<para>Non tutti i sistemi supportano sia APM che ACPI. Io ho cambiato poich&eacute; il mio sistema
supportava soltanto l'ACPI. Quindi una decisione piuttosto facile. Se decidete di cambiare per avere il
supporto <ulink url="http://acpi.sourceforge.net/documentation/sleep.html">S3</ulink> (sospensione in
RAM) e non state usando un kernel 2.4.x, non preoccupatevi. Non <ulink
url="http://lists.debian.org/debian-laptop/2003/debian-laptop-200304/msg00418.html"> &egrave; supportato</ulink>.
Punto e basta.</para>

<para>Non si &egrave; sicuri che il proprio sistema sia supportato? ACPI4Linux ha una lista di <ulink
url="http://acpi.sourceforge.net/wiki/index.php/InstallationReports">
macchine e BIOS</ulink> supportati nel proprio Wiki. Siete invitati a contribuire all'aggiornamento
della lista se avete installato l'ACPI! Vi &egrave; anche una lista di macchine che <ulink url="http://acpi.sourceforge.net/documentation/blacklist.html">non sono supportate</ulink>.</para>

<para>Per ulteriori informazioni sulla gestione dell'alimentazione nei portatili, &egrave; (inoltre) utile il
<ulink url="http://www.tldp.org/HOWTO/mini/Battery-Powered/index.html">Battery Power Linux mini-HOWTO</ulink>.</para>

</sect1>

<sect1 id="dsdt">
<title>La DSDT: Differentiated System Description Table</title>
<para>Grazie a <ulink url="http://www.vitavonni.de/">Erich</ulink> che ha scritto questa sezione.</para>

<para>Potrebbe essere necessario sovrascrivere la DSDT qualora alcune caratteristiche, come lo stato delle batterie,
vengano erroneamente riportate (di solito causando messaggi di errore sul log di sistema).
I portatili DELL solitamente hanno bisogno di questo tipo di intervento. DSDT corrette per diversi sistemi
sono disponibile sulla <ulink url="http://acpi.sourceforge.net/dsdt/index.php">pagina DSDT</ulink>, insieme
ad una patch che indica al kernel di ignorare la tabella fornita dal BIOS, in favore della DSDT corretta 
contenuta nella patch stessa.</para>

<para>Fondamentalmente, &egrave; necessario copiare la tabella corretta
nel sorgente del kernel con uno specifico nome di file (o
modificare il nome del file nella patch fornita dalla <ulink
url="http://acpi.sourceforge.net/dsdt/index.php">pagina DSDT</ulink>)
Questa sostituzione &egrave; abbastanza facile: invece di caricare la tabella DSDT dal BIOS, il kernel utilizza la
tabella DSDT compilata nella patch. E questo &egrave; tutto.</para>
</sect1>

<sect1 id="install">
<title>Installazione dai sorgenti</title>
<para>ACPI viene costantemente sottoposto a revisioni. &Egrave; disponibile nelle ultime versioni
dei kernel della serie 2.4.x (2.4.22 e superiori) e in tutti i kernel della serie 2.6.x. Se si volesse
utilizzare un kernel precedente alla versione 2.4.22, &egrave; necessario applicare una patch ai sorgenti del
kernel per aggiungere le funzionalit&agrave;  di ACPI. Se possibile, si dovrebbe impiegare l'ultima versione
stabile del kernel. Le patch sono disponibili su
<ulink url="http://acpi.sourceforge.net">acpi.sourceforge.net</ulink>.</para>

<para>Red Hat Fedora Core 2 ora viene fornita con ACPI attivata di default. Questo
&egrave; un bel passo avanti per il gruppo di sviluppo di ACPI. Congratulazioni a tutti.</para>

<note>
	<para>Perfino l'ultimo kernel talvolta avr&agrave;  piccole correzioni disponibili come patch.
	Si dovrebbe controllare il sito web di ACPI4Linux per verificare se vi sono disponibili
	delle patch.</para>
</note>

<para>&Egrave; necessario recuperare la patch che corrisponde esattamente alla versione del kernel che si sta
utilizzando. Poich&eacute; questa &egrave; la sezione <quote>installazione dai sorgenti</quote> si assume che sia noto
il kernel che si ha intenzione di installare.</para>

<sect2 id="kernelchoice">
<title>Scelta del kernel</title>
<para>Questo documento &egrave; stato scritto originariamente per il kernel versione 2.4.20 ed &egrave; stato aggiornato
per includere informazioni sui kernel della serie 2.6.x. Al momento di questo aggiornamento i kernel della
serie 2.6.x si sono rivelati facili per alcuni e difficili per altri. Personalmente, non sono stata in grado
di spegnere correttamente il mio computer con il kernel 2.6.5).</para>

<para>Se possibile, vorrei raccomandare di attendere prima di aggiornare il proprio kernel alla serie 2.6.x,
almeno fino a che non siano stati risolti ulteriori bachi. Vi sono <emphasis>moltissimi</emphasis>
cambiamenti nei kernel della serie 2.6.x. Quando ho aggiornato il mio kernel alla versione 2.6.5, per poter
aggiornare questo documento, ho incontrato problemi con la connessione wireless, la scheda
grafica nvidia e con l'ACPI. Il vostro iter pu&ograve; essere diverso. Personalmente, ho avuto un buon successo con
la versione 2.4.20 cui avevo applicato l'ultima patch, e con il kernel 2.4.22 senza alcuna patch. Una ricerca
nella mailing list della propria distribuzione e in quella acpi-devel dovrebbe essere di aiuto per individuare
il kernel giusto.</para>

<note>
	<para>Questo documento utilizza il kernel 2.4.20 come esempio per tutti i kernel della serie 2.4.x.
	Si sostituisca opportunamente la propria versione del kernel.</para>
</note>

<para>Indipendentemente da quale kernel si sceglie, se &egrave; un kernel che richiede l'uso di una patch, &egrave;
importante utilizzare l'ultima versione della patch ACPI. Alcune distribuzioni hanno gi&agrave;  applicato una
patch al proprio kernel. Questo &egrave; il caso della Debian e potrebbe essere analogo per altre distribuzioni.
Per maggiori informazioni sulle patch che sono state applicate ai sorgenti del kernel Debian
si pu&ograve; cercare in:
<filename>/usr/src/kernel-source-&kernel-version;/README.Debian</filename>. Se non si utilizza una
distribuzione Debian, probabilmente sar&agrave;  possibile trovare un file equivalente per la propria
distribuzione.</para>

<para>Sulla mailing list acpi-support, un utente confermava che non era necessaria alcuna delle patch
addizionali che erano state applicate al kernel per far funzionale il mio portatile.
Se la macchina che si intende utilizzare &egrave; un server di produzione e/o un server web per internet, si
dovrebbero applicare tutte le patch addizionali relative alla sicurezza.</para>

<warning><para>Se un kernel ha altre patch applicate, si potrebbero avere problemi
nell'installazione della patch ACPI. Naturalmente, una patch ACPI non dovrebbe essere
applicata ad un kernel che ha gi&agrave; una patch per ACPI. Anche se non sono mai state applicate
al kernel patch ACPI, &egrave; possibile applicarne una in seguito. A seconda delle patch applicate,
potrebbe essere necessario modificare uno o pi&ugrave; dei Makefile per installare la patch con
successo. Questo aspetto va oltre gli scopi prefissi, quindi non &egrave; trattato in questo
documento.</para></warning>

<sect3 id="debianizedkernel">
<title>Kernel Debianizzato comprensivo di patch</title>
<para>Se si preferisce utilizzare un kernel Debianizzato invece di uno base,
<ulink url="http://people.debian.org/~maxx">maxx</ulink> ha fornito i sorgenti
del kernel comprensivi dell'ultima patch per il kernel 2.4.20.
Potrebbe essere utilizzato questo invece di scaricare un kernel base (senza patch) da <ulink url="http://www.kernel.org">www.kernel.org</ulink>.
Mi ha inviato una email con le seguenti osservazioni:</para>

<blockquote>
<attribution><ulink url="http://people.debian.org/~maxx">maxx</ulink></attribution>
<para>Ho preso i sorgenti del kernel 2.4.20-8 instabile, ho rimosso le modifiche ACPI
[cio&egrave; la vecchia patch] ed ho applicato <filename>acpi-20021212-2.4.20.diff.gz</filename> di acpi.sf.net
poich&eacute; la versione vanilla 2.4.20 <emphasis>HA</emphasis> diverse carenze di sicurezza (ptrace, hash table, ...).</para>

<para>Si pu&ograve; trovare il pacchetto all'indirizzo <ulink
url="http://people.debian.org/~maxx/kernel-source-2.4.20/">http://people.debian.org/~maxx/kernel-source-2.4.20/</ulink>
(Non ho fatto l'upload del .orig.tar.gz poich&eacute; &egrave; disponibile su un qualunque mirror del sito debian
ed il .deb &egrave; gi&agrave;  grande abbastanza)</para>
</blockquote>

<warning>
<para>Non ho provato questo pacchetto. &Egrave; possibile avervi pi&ugrave; o meno successo. Si prega di non
inviare all'autrice alcuna email che riguardi questo pacchetto, bens&igrave; di inviarla a maxx.</para>
</warning>
</sect3>
</sect2>
</sect1>

<sect1 id="backups">
<title>Backup</title>
<para>Se si sta gi&agrave;  utilizzando un kernel che &egrave; della medesima versione di quello cui si ha intenzione di
applicare la patch, si raccomanda di creare una nuova directory per il nuovo kernel con la patch.
Si ricordi che i backup non sono <emphasis>mai</emphasis> una cattiva cosa. Questi sono i file di cui io ho fatto il
back up:</para>

<itemizedlist>
	<listitem><para><filename>/etc/lilo.conf</filename></para></listitem>
	<listitem><para><filename>/usr/src/*.deb</filename>
	 (specifici di Debian)</para></listitem>
	<listitem><para><filename>/etc/modules</filename></para></listitem>
	<listitem><para><filename>/etc/modutils/aliases</filename></para></listitem>
	<listitem><para><filename>/usr/src/linux/.config</filename></para></listitem>
	<listitem><para>Se <emphasis>non</emphasis> si sta seguendo il Modo Debian, si dovrebbe eseguire il
	back up anche della directory <filename class="directory">/lib/modules</filename> e dei file <filename>/boot/vmlinuz</filename>, <filename>/usr/src/linux/arch/i386/boot/bzImage</filename> e <filename>/usr/src/System.map</filename>. &Egrave; possibile che queste indicazioni sulla locazione dei file siano
	differenti. Si effettui un <userinput><command>locate</command> <replaceable>&lt;file&gt;</replaceable></userinput> se non sono dove indicato.</para></listitem>
</itemizedlist>
</sect1>

<sect1 id="kernelprep">
<title>Scaricare e decomprimere il nuovo kernel</title>

<sect2 id="requiredpackages">
<title>Pacchetti richiesti</title>
<para>La seguente &egrave; una lista dei pacchetti richiesti per applicare patch ai kernel della serie 2.4.x.
Sto ancora lavorando sulle note per l'installazione di una serie 2.6.x.</para>

<itemizedlist>
	<title>kernel serie 2.4.x</title>
	<listitem><para>file sorgenti del kernel </para></listitem>
	<listitem><para>patch ACPI che corrisponda esattamente alla versione del kernel</para></listitem>
	<listitem><para>pacchetti debian: make, bzip2, gcc, libc6-dev, tk8.3,
	libncurses5-dev, kernel-package</para></listitem>
	<listitem><para>dopo aver applicato la patch al kernel si aggiungano i pacchetti debian: acpid, acpi (quest'ultimo &egrave; disponibile nelle versioni test ed instabile, ma non in versione stabile)</para></listitem>
</itemizedlist>
</sect2>

<sect2 id="unpack">
<title>Decompressione</title>
<para>&Egrave; necessario decomprimere il file bz2 (bzip2) e riorganizzare un pò le directory.
<filename class="directory">/usr/src/linux</filename> probabilmente punta al kernel attualmente in uso.
&Egrave; necessario fare in modo che punti al nuovo kernel, quindi faremo anche questo.</para>
<itemizedlist>
	<listitem><para>
		<command>
			cd <filename class="directory">/usr/src</filename>
		</command>
	</para></listitem>

	<listitem><para>
		<command>mkdir <filename
		class="directory">kernel-source-&kernel-version;</filename>
		</command>
	 (si utilizzi un nome alternativo se esiste gi&agrave;  una versione installata di questo kernel)
	</para></listitem>

	<listitem><para>
		<command>cp
		<filename>linux.&kernel-version;.tar.bz2</filename>
		<filename>/usr/src/kernel-source-&kernel-version;</filename>
		</command>
	</para></listitem>

	<listitem><para>
		<command>cd
		<filename
		class="directory">/usr/src/kernel-source-&kernel-version;</filename>
		</command>
	</para></listitem>

	<listitem><para>
		<command>tar <option>xjfv</option>
		<filename>linux.&kernel-version;.tar.bz2</filename></command>
	</para></listitem>

	<listitem><para>
		<command>mv
		<filename
		class="directory">linux.&kernel-version;</filename>
		<filename
		class="directory">/usr/src/linux-&kernel-version;</filename>
		</command>
	</para></listitem>


	<listitem><para>
		<command>rm <filename>linux</filename></command>
		 (assumendo che questo sia un link al vecchio kernel)
	</para></listitem>

	<listitem><para>
		<command>ln <option>-s</option>
		<filename>/usr/src/linux-&kernel-version;</filename>
		<filename>linux</filename>
		</command>
	</para></listitem>
</itemizedlist>

<para>Se il proprio kernel ha bisogno di una patch, &egrave; il momento di applicarla. Le istruzioni
sono disponibili in <xref linkend="patch" />.</para>

</sect2>
</sect1>

<sect1 id="kernelconfig">
<title>Configurare il nuovo kernel</title>

<note>
	<title>Prima si applichi la patch al kernel</title>
	<para>Se si sta utilizzando un vecchio kernel, &egrave; necessario applicare la patch prima di procedere.
	Istruzioni su come applicare la patch al kernel sono disponibili in <xref linkend="patch"/>. I kernel
	della serie 2.6.x non hanno bisogno di patch.</para>
</note>

<para>Ora, invece di utilizzare <command>make <parameter>menuconfig</parameter></command>, c'&egrave; un'ottima
alternativa. Verificatela: si copi il file <filename>.config</filename> corrente nella directory
<filename class="directory">/usr/src/linux</filename>.
Si usi quindi <quote><command>make <parameter>oldconfig</parameter></command></quote>. Il comando effettuer&egrave; una scansione del vecchio file di configurazione, verificando gli aggiornamenti in modo da non obbligarvi a cercare
tutte le nuove opzioni.
Per <emphasis>tutto</emphasis> quello che ha a che fare con ACPI ed il proprio hardware specifico (chi ha Toshiba
scelga le opzioni Toshiba, chi ha Asus scelga le opzioni Asus) si risponda <option>M</option> per modulo.
Vi sono una decina di opzioni connesse a ACPI che &egrave; necessario selezionare.</para>

<para>Al dunque, punto per punto, il kernel dovrebbe essere configurato come segue:</para>

<itemizedlist>
	<listitem><para>
		<command>cd
		<filename class="directory">/usr/src/linux</filename>
		</command>
	</para></listitem>

	<listitem><para>
		<command>cp
		<filename>/usr/src/<replaceable>&lt;oldkernel-source-directory&gt;</replaceable>/.config</filename>
		<filename>.config</filename>
		</command>
	</para></listitem>

	<listitem><para>
	<command>make <parameter>oldconfig</parameter></command>
	(rispondere <option>M</option> a tutte le nuove opzioni per
	ACPI -- &egrave; anche possibile rispondere <quote><option>Y</option></quote> se si preferisce compilarlo
	direttamente nel kernel)
	</para></listitem>
</itemizedlist>

<para>Ora si entri nel file di configurazione con <command>make
<parameter>menuconfig</parameter></command>. Bisogna controllare
di avere disabilitato l'APM (il precedente strumento di controllo dell'alimentazione). Alla voce
<quote><menuchoice><guimenu>General Setup</guimenu></menuchoice></quote>, si verifichi che:</para>
<itemizedlist>
	<listitem><para>
		<menuchoice><guimenuitem>Power Management Support</guimenuitem></menuchoice>
		sia su ON</para></listitem>
        <listitem><para>
		<menuchoice><guimenuitem>APM (Advanced Power
	Management)</guimenuitem></menuchoice> sia su OFF (questo &egrave; il vecchio strumento,
	non occorre che sia disponibile, neanche come modulo, a meno che non si sappia esattamente
	cosa si sta facendo. E se lo si sa, probabilmente non &egrave; necessario leggere questo documento.)
	</para></listitem>
        <listitem><para>tutto quello che riguarda ACPI deve essere impostato su
	<option>M</option> (caricato come modulo) o <option>*</option> (compilato
	direttamente nel kernel). Si legga la lista <emphasis>attentamente</emphasis>: alcune
	opzioni non saranno applicabili al proprio hardware.</para></listitem>
</itemizedlist>
<para>si esca salvando la nuova configurazione</para>
</sect1>

<sect1 id="kernelcompile">
<title>Compilare il nuovo kernel</title>

<para>Se vi sono moduli addizionali che non sono parte dell'albero principale dei sorgenti,
&egrave; necessario aggiungere i file immagine dei moduli quando si creano i pacchetti Debian.
Questo &egrave; pressoch&eacute; inevitabile se si sta usando un portatile ed un kernel pi&ugrave; vecchio. Ora solo la mia
scheda grafica nvidia richiede moduli addizionali.</para>

<itemizedlist>
	<listitem><para>
		<command>cd
		<filename class="directory">/usr/src/linux</filename>
		</command>
	</para></listitem>

	<listitem><para>
		<command>make-kpkg <parameter>clean</parameter></command>
	</para></listitem>

	<listitem><para>
		<command>make-kpkg
			<option>--append-to-version=.&lt;date&gt;</option>
			<parameter>kernel_image</parameter>
			<parameter>modules_image</parameter>
		</command>
	</para></listitem>
</itemizedlist>

<note>
<title>Nominare le versioni del kernel </title>
<para>Io non uso pi&ugrave; le estensioni .<replaceable>data</replaceable> per distinguere le varie
versioni del kernel. &Egrave; molto frustrante avere numerazioni quali 030627a, 032627b, ecc. quando si
cerca di capire le cose. Attualmente utilizzo dei nomi, in ordine alfabetico, cominciando dalla versione
del kernel <quote>alien</quote>. Ho intenzione di abbandonare l'opzione delle date, anche se penso ancora che
sia un buon metodo.</para>
<para>Il mio attuale kernel, 2.6.6, &egrave; <quote>Elrond</quote>.
La macchina &egrave; <quote>Smeagol</quote>.
</para></note>

&kernel-compile;
</sect1>

<sect1 id="kernelinstall">
<title>Installare il nuovo kernel</title>
<para>Personalmente preferisco configurare da me lilo, ma voi fare come meglio credete.</para>
<itemizedlist>
	<listitem><para>
		<command>cd
		<filename class="directory">/usr/src</filename>
		</command>
	</para></listitem>

	<listitem><para>
		<command>dpkg <option>-i</option>
		kernel-image-&kernel-version;.&kernel-name;_10.00.Custom_i386.deb</command>
	A questo punto, scarto <emphasis>tutti</emphasis> gli aggiornamenti di lilo e lo configuro
	a mano da me.
	</para></listitem>

	<listitem><para>configurare lilo manualmente: <command>vi
	<filename>/etc/lilo.conf</filename></command>
	</para></listitem>


	<listitem><para>
	caricare il nuovo kernel in lilo: <command>lilo</command>
	</para></listitem>

	<listitem><para>
	Se avete altri file deb per altri moduli, &egrave; necessario
	installarli a parte adesso. In caso di dubbio, controllare
	<filename class="directory">/usr/src</filename> per ulteriori file
	<filename class="extension">.deb</filename>.
	</para></listitem>
</itemizedlist>

&kernel-compile;
</sect1>

<sect1 id="finishinstall">
<title>Riavvio e verifica</title>
<para>A questo punto bisognerebbe riavviare la macchina. Quando il sistema &egrave; di nuovo in piedi
(assumendo naturalmente che tutto sia andato per il verso giusto e che si abbia nuovamente
un sistema), si verifichi il kernel in esecuzione con <command>uname<option>-a</option></command>.
Il comando dovrebbe mostrare la versione appena compilata. Inoltre, si dovrebbe verificare
di aver installato la patch giusta. Questo pu&ograve; essere fatto con
<userinput>
	<command>dmesg</command> |
	<command>grep <parameter>ACPI.*Subsystem\ revision</parameter></command>
</userinput>. Che dovrebbe produrre:
<computeroutput>ACPI: Subsystem revision 20021212</computeroutput>. La
revisione &egrave; la data in cui la patch &egrave; stata rilasciata. Questo numero sar&agrave;  differente dal mio
se non si sta utilizzando il kernel 2.4.20.
Per vedere tutto ci&ograve; che viene caricato/avviato relativamente ad ACPI al boot del sistema, si esegua:
	<userinput><command>dmesg</command> |
	<command>grep <parameter>ACPI</parameter></command>
</userinput>.
<command>dmesg</command> mostra i messaggi di avvio e <command>grep
<parameter>ACPI</parameter></command> fa in modo che vengano mostrati solo i messaggi connessi a ACPI.</para>

<para>Si pu&ograve; verificare la versione che si sta utilizzando anche con <command>cat
<filename>/proc/acpi/info</filename></command>. Non si deve credere a tutto quello che si legge. A me 
viene indicato che S3 &egrave; uno stato supportato, ma sappiamo gi&agrave;  che non &egrave; vero. Tuttavia la versione mostrata &egrave; quella
corretta, cosa questa molto utile.</para>
</sect1>

<sect1 id="loadmodules">
<title>Caricare i moduli</title>
<para>Si verifichi che ogni modulo ACPI sia stato caricato dopo l'avvio della macchina. Si pu&ograve; usare il
comando <command>lsmod</command>. Bisogna cercare le opzioni seguenti: button, battery, fan, ac,
thermal e processor (NdT. pulsante, batteria, ventola, corrente alternata, temperatura e processore). Se si &egrave;
scelto <quote>Y</quote> invece dei moduli prima di compilare il kernel, non si riuscir&agrave; a vedere
questa lista. L'output sul mio computer assomiglia a questo:</para>

<screen>
Module                  Size  Used by    Tainted: P
button                  2420   0 (unused)
battery                 5960   0 (unused)
ac                      1832   0 (unused)
fan                     1608   0 (unused)
thermal                 6664   0 (unused)
processor               8664   0 [thermal]
NVdriver              945408  11
</screen>

<para>L'ultimo modulo &egrave; la mia scheda grafica, che utilizza driver proprietari. Questo &egrave; il motivo della
presenza della <quote>P</quote> accanto a Tainted nella linea superiore.</para>

<para>Se si &egrave; compilato il supporto ACPI come <quote>M</quote>oduli e non si riesce a vedere la lista dei moduli
ACPI, si avr&agrave;  bisogno di caricarli manualmente. I moduli dovrebbero essere collocati in
<filename class="directory">/lib/modules/&kernel-version;.
&kernel-name;/kernel/drivers/acpi/</filename> e sono i seguenti:</para>

<screen>
-rw-r--r--    1 root     root         4.1k Jun  3 23:57 ac.o
-rw-r--r--    1 root     root         9.5k Jun  3 23:57 battery.o
-rw-r--r--    1 root     root         5.2k Jun  3 23:57 button.o
-rw-r--r--    1 root     root         3.7k Jun  3 23:57 fan.o
-rw-r--r--    1 root     root          14k Jun  3 23:57 processor.o
-rw-r--r--    1 root     root          11k Jun  3 23:57 thermal.o
-rw-r--r--    1 root     root         6.2k Jun  3 23:57 toshiba_acpi.o
</screen>

<note>
<title>Estensioni per i moduli</title>
<para>Il nome del modulo &egrave; tutto ci&ograve; che precede l'estensione <filename class="extension">.o</filename>
nel nome del file. <filename>processor.o</filename> &egrave; il file, e processor &egrave; il nome del modulo.
Per installare un modulo kernel si usi:
<command>insmod <replaceable>processor</replaceable></command>.</para>

<para>I kernel della serie 2.4.x utilizzano l'estensione <filename class="extension">.o</filename>;
tuttavia, i kernel della serie 2.6.x utilizzano l'estensione <filename class="extension">.ko</filename>.
</para>
</note>

<para>La prima volta che ho riavviato, li ho caricati tutti a mano, digitando <command>insmod <replaceable>
&lt;modulename&gt;</replaceable></command>. Personalmente, ho caricato prima processor, anche se vi sono
diverse indicazioni sull'importanza o meno della sequenza di caricamento.</para>

<note>
<title>Operating System Power Management (OSPM)</title>
<para>La prima volta che l'ho provato, i moduli erano tutti in
directory separate e si chiamavano ospm_&lt;name&gt;. Probabilmente era dovuto al fatto
di aver utilizzato una patch vecchia, ma &egrave; bene fare attenzione. I moduli OSPM
ora sono deprecati, cos&igrave; probabilmente non si incontranno affatto.</para>
</note>

<para>Per evitare di caricare i moduli ogni volta che viene fatto un riavvio, si
possono fare due cose: compilarli direttamente nel kernel (un po' tardi per pensarci adesso, eh?)
oppure aggiungerli al file <filename>/etc/modules</filename>. Se non si ha gi&egrave; una copia
del file, basta crearne uno nuovo aggiungendovi tutti i nomi dei moduli (si rammenti di non mettere l'estensione),
uno per riga. Si pu&ograve; anche provare ad eseguire <command>update-modules</command> che dovrebbe
automaticamente aggiornare il file di configurazione <filename>/etc/modules.conf</filename>.</para>
</sect1>

<sect1 id="daemons">
<title>Passare da APM a ACPI</title>
<para>Non bisogna far girare simultaneamente l'<application>apmd</application> e
l'<application>acpid</application> a meno che REALMENTE non si sappia cosa si sta
facendo. Debian <emphasis>non</emphasis> assicura che ne giri uno solo per volta. &Egrave; vostro compito
controllare che ci&ograve; non avvenga.
L'APM prover&agrave; a mettere il vostro sistema nello stato S3. Sui kernel della serie 2.4.x (e precedenti)
questo molto probabilmente bloccher&agrave; la macchina. S3 non &egrave; supportato che dalla versione 2.5.x.
Neanche la patch fornisce supporto per l'S3 nei kernel della serie 2.4.x. Personalmente ho eseguito un
<command>apt-get remove apmd</command> per risolvere i problemi di blocco.</para>

<para>Bisogna fare attenzione anche ad un'altra anomalia che ho scoperto. Il server
XFree86 ha una opzione per il sistema DPMS (Energy Star). Il DPMS pu&ograve; essere in uno dei
seguenti stati: standby, suspend (NdT "sospeso"), spento o acceso.
Poich&eacute; i kernel 2.4.x non possono essere sospesi su disco, si possono avere problemi. Ho corretto il mio
sistema facendo due cose:</para>
<itemizedlist>
	<listitem><para>
		<command>xset <option>-dpms</option></command> (disabilita il DPMS)
	</para></listitem>

	<listitem><para>
		Nel file <filename>/etc/X11/XF86Config-4</filename> ho commentato la linea
		<option>Option "DPMS"</option> nella sezione "Monitor".
	</para></listitem>
</itemizedlist>
<!-- tradurre questo warning Linee 715 - 1.2 e 726 - 1.12 sul diff -->
<warning>
	<title>Perdita degli interrupt del touchpad e della tastiera</title>
	<para>Karl Hegbloom mi ha inviato una e-mail in cui dice che <quote>il polling
	sullo stato delle batterie via ACPI ed il file system proc causano il blocco
	dei tasti della tastiera, salti improvvisi attraverso lo schermo del puntatore del
	"touchpad", rallentamenti nel corso di onerose operazioni di I/O di rete.</quote>
	Questo problema &egrave; causato, in parte, da un ritardo tra la richiesta iniziale per avere
	informazioni sullo stato delle batterie e la relativa risposta. In questo
	intervallo di tempo, gli interrupt possono essere congelati e pu&ograve; andare
	perduta la sincronizzazione con la tastiera ed il "touchpad".
	<quote>La soluzione immediata consiste nel disabilitare l'applicazione di monitoraggio delle batterie,
	oppure ridurre la sua frequenza di polling.</quote> Karl ha
	anche osservato che un aggiornamento del BIOS &egrave; in grado di risolvere il problema.
	Grazie Karl!</para>

<para>
	Non ho incontrato questo problema utilizzando i kernel 2.4.x,
	tuttavia, si &egrave; verificato quando ho aggiornato il kernel alla versione 2.6.5. Io uso
	<application>wmacpi</application> per controllare lo stato delle batterie. Impostando
	la frequenza di polling ad 1 (il valore pi&ugrave; basso possibile), mi &egrave; sembrato di aver
	eliminato i blocchi del "touchpad". Nel mio file <filename>.xinitrc</filename> ho inserito:
</para>

<para>
<userinput>
<command>/usr/bin/wmacpi</command> <parameter>-s 1</parameter>
</userinput>
</para>

<para>
	Il parametro <parameter>-s 1</parameter> rappresenta la frequenza di polling
	(frequenza di campionamento) pari a <quote>una volta al minuto.</quote> L'impostazione
	predefinita &egrave; 20.
</para>
</warning>


</sect1>

<sect1 id="usingacpi">
<title>Utilizzare l'ACPI</title>
<para>Ci sono poche applicazioni e demoni che potreste voler installare sul vostro sistema:
<application>acpid</application> (il demone che controlla lo stato dell'hardware) e
<application>acpi</application> (l'interfaccia per monitorare eventi e stati) costituiscono l'installazione di base. Il
pacchetto Debian <application>acpi</application> &egrave; disponibile nella versione di test ed non &egrave; stabile. Se
il vostro sistema &egrave; stabile, non potrete installarlo senza giocare un po' con apt ed il file  <filename>list.sources</filename>. Probabilmente potreste anche compilarlo da sorgente. Una volta installato
<application>acpi</application>, si potr&agrave; utilizzarlo per monitorare il proprio sistema come segue:
<command>acpi <option>-V</option></command>. L'output fornir&egrave; informazioni sul sistema.
Il mio risulta come segue:</para>
<screen>
     Thermal 1: ok, 47.1 degrees C
     Thermal 2: ok, 45.1 degrees C
  AC Adapter 1: off-line &lt;-- batterie esaurite
  AC Adapter 1: on-line &lt;-- alimentazione AC
</screen>

<para>Sfortunatamente, l'opzione <option>-V</option> <quote>full version</quote> non funziona sul mio sistema.
Tuttavia, fortunatamente, posso ancora controllare ciascuno dei file acpi per ricavare informazioni sul mio sistema.
Si cerchino nella directory <filename class="directory">/proc/acpi</filename> le cose che possono interessare.
Se voglio controllare lo stato delle batterie, leggo il file relativo con il comando: <command>cat
<filename>/proc/acpi/battery/BAT0/state</filename></command>. Il risultato &egrave; il seguente:</para>

<screen>
present:                 yes
capacity state:          ok
charging state:          discharging &lt;-- batterie in esaurimento
present rate:            unknown
remaining capacity:      3920 mAh &lt;-- controllare questo numero
present voltage:         14800 mV
</screen>

<screen>
present:                 yes
capacity state:          ok
charging state:          discharging
present rate:            unknown
remaining capacity:      3840 mAh &lt;-- la capacit&agrave; sta diminuendo
present voltage:         14800 mV
</screen>

<screen>
present:                 yes
capacity state:          ok
charging state:          charging &lt;-- alimentatore AC inserito
present rate:            unknown
remaining capacity:      3840 mAh
present voltage:         14800 mV
</screen>

<para>Se voglio informazioni generali sulle batterie, posso controllarle con:
<command>cat <filename>/proc/acpi/battery/BAT0/info</filename></command></para>

<screen>
present:                 yes
design capacity:         3920 mAh
last full capacity:      3920 mAh
battery technology:      rechargeable
design voltage:          14800 mV
design capacity warning: 30 mAh
design capacity low:     20 mAh
capacity granularity 1:  10 mAh
capacity granularity 2:  3470 mAh
model number:            Bat0
serial number:
battery type:            Lion
OEM info:                Acer
</screen>

<para>Siete persone intelligenti. Potete fare le vostre deduzioni. :)</para>
</sect1>

<sect1 id="resources">
<title>Riferimenti e risorse</title>
<para>Le seguenti URL sono state molto utili nella stesura di questo HOWTO ed in generale per
configurare e far funzionare l'ACPI.</para>

<variablelist>
	<title>HOWTO</title>

	<varlistentry>
	<term>HOWTO install ACPI under Linux</term>
	<listitem><para>
	<ulink url="http://sylvestre.ledru.info/howto/howto_acpi.php">
		http://sylvestre.ledru.info/howto/howto_acpi.php
	</ulink>
	</para></listitem>
	</varlistentry>

	<varlistentry>
	<term>Linux ACPI-HOWTO</term>
	<listitem><para>
	<ulink url="http://www.columbia.edu/~ariel/acpi/acpi_howto.txt">
		http://www.columbia.edu/~ariel/acpi/acpi_howto.txt
	</ulink>
	</para></listitem>
	</varlistentry>

	<varlistentry>
	<term>Linux on the road</term>
	<term>altrimenti detto:
		<ulink url="http://www.tldp.org/HOWTO/Laptop-HOWTO.htm">
		Linux Laptop HOWTO
		</ulink>
	</term>
	<listitem><para>
	<ulink url="http://tuxmobil.org/howtos.html">
		http://tuxmobil.org/howtos.html
	</ulink>
	&Egrave; necessario navigarci un po', od usare la versione in HTML:
	<ulink url="http://tuxmobil.org/Mobile-Guide.db/Mobile-Guide.html">
		http://tuxmobil.org/Mobile-Guide.db/Mobile-Guide.html
	</ulink>
	</para></listitem>
	</varlistentry>

	<varlistentry>
	<term>Hardware in Detail (sezione di Linux on the road)</term>
	<listitem><para>
	<ulink url="http://tuxmobil.org/Mobile-Guide.db/mobile-guide-p2c1-hardware-in-detail.html">
		http://tuxmobil.org/Mobile-Guide.db/mobile-guide-p2c1-hardware-in-detail.html
	</ulink>
	</para></listitem>
	</varlistentry>

	<varlistentry>
	<term>Power Management with Linux - APM, ACPI, PMU</term>
	<listitem><para>
	<ulink url="http://tuxmobil.org/apm_linux.html">
		http://tuxmobil.org/apm_linux.html
	</ulink>
	</para></listitem>
	</varlistentry>

	<varlistentry>
	<term>Battery Powered Linux Mini-HOWTO</term>
	<listitem><para>
	<ulink url="http://www.tldp.org/HOWTO/mini/Battery-Powered/">
		http://www.tldp.org/HOWTO/mini/Battery-Powered/
	</ulink>
	</para></listitem>
	</varlistentry>

	<varlistentry>
	<term>Creating custom kernels with Debian's Kernel-Package system</term>
	<listitem><para>
	<ulink url="http://newbiedoc.sourceforge.net/system/kernel-pkg.html">
		http://newbiedoc.sourceforge.net/system/kernel-pkg.html
	</ulink>
	</para></listitem>
	</varlistentry>
</variablelist>

<variablelist>
	<title>Report e informazioni sull'installazione di hardware specifico</title>

	<varlistentry>
	<term>Installation reports</term>
	<listitem><para>
	<ulink url="http://acpi.sourceforge.net/wiki/index.php/InstallationReports">
		http://acpi.sourceforge.net/wiki/index.php/InstallationReports
	</ulink>
	</para></listitem>
	</varlistentry>

	<varlistentry>
	<term>Blacklist</term>
	<listitem><para>
	<ulink url="http://acpi.sourceforge.net/documentation/blacklist.html">
		http://acpi.sourceforge.net/documentation/blacklist.html
	</ulink>
	</para></listitem>
	</varlistentry>

	<varlistentry>
	<term>DSDT: overview</term>
	<listitem><para>
	<ulink url="http://acpi.sourceforge.net/dsdt/index.php">
		http://acpi.sourceforge.net/dsdt/index.php
	</ulink>
	Include link a DSDT con patch e HOWTO su come applicare patch al proprio DSDT.
	</para></listitem>
	</varlistentry>

	<varlistentry>
	<term>BIOS settings for the AcerTM (Phoenix BIOS)</term>
	<listitem><para>
	<ulink url="http://help.nec-computers.com/au/pri/item_instr_bios_7521N.asp">
		http://help.nec-computers.com/au/pri/item_instr_bios_7521N.asp
	</ulink>
	</para></listitem>
	</varlistentry>
</variablelist>

<variablelist>
	<title>Gruppi di sviluppo software </title>

	<varlistentry>
	<term>ACPI4Linux</term>
	<listitem><para>
	<ulink url="http://acpi.sf.net">
		http://acpi.sf.net
	</ulink>
	</para></listitem>
	</varlistentry>

	<varlistentry>
	<term>ACPI Special Interest Group</term>
	<listitem><para>
	<ulink url="http://www.acpi.info/">
		http://www.acpi.info/
	</ulink>
	</para></listitem>
	</varlistentry>

	<varlistentry>
	<term>Intel</term>
	<listitem><para>
	<ulink url="http://developer.intel.com/technology/iapc/acpi/">
		http://developer.intel.com/technology/iapc/acpi/
	</ulink>
	</para></listitem>
	</varlistentry>
</variablelist>

<variablelist>
	<title>Articoli su ACPI</title>
	<varlistentry>
		<term>Fan Speed Control Techniques in PCs</term>
		<listitem><para>
		<ulink url="http://www.analog.com/library/analogDialogue/archives/34-04/fan/">
		http://www.analog.com/library/analogDialogue/archives/34-04/fan/
		</ulink>
		</para></listitem>
	</varlistentry>
</variablelist>

<variablelist>
<title>Thread presi da alcune Mailing List </title>
	<varlistentry>
	<term>debian-laptop thread: can't restore from suspend</term>
	<listitem><para>
	<ulink url="http://lists.debian.org/debian-laptop/2003/debian-laptop-200304/msg00367.html">
		http://lists.debian.org/debian-laptop/2003/debian-laptop-200304/msg00367.html
	</ulink>
	</para></listitem>
	</varlistentry>

	<varlistentry>
	<term>acpi-support thread: newbie HOWTO and debian patching</term>
	<listitem><para>
	<ulink url="http://sourceforge.net/mailarchive/forum.php?forum_id=7803&amp;max_rows=25&amp;style=flat&amp;viewmonth=200304&amp;viewday=17">
http://sourceforge.net/mailarchive/forum.php?forum_id=7803&amp;max_rows=25&amp;style=flat&amp;viewmonth=200304&amp;viewday=17
	</ulink>
	</para></listitem>
	</varlistentry>

	<varlistentry>
	<term>debian-laptop thread: acer 634 acpi &amp; apm</term>
	<listitem><para>
	<ulink url="http://lists.debian.org/debian-laptop/2002/debian-laptop-200212/msg00242.html">
		http://lists.debian.org/debian-laptop/2002/debian-laptop-200212/msg00242.html
	</ulink>
	</para></listitem>
	</varlistentry>

</variablelist>

<variablelist id="software" xreflabel="ACPI packages and related software">
<title>Pacchetti ACPI e software correlati</title>
	<varlistentry>
	<term>Il Kernel</term>
	<listitem><para>Si ricordi di scegliere "F" (per "full" - completo) quando si scaricano i 
	sorgenti del kernel.
	<ulink url="http://www.kernel.org">
		http://www.kernel.org
	</ulink>
	</para></listitem>
	</varlistentry>

	<varlistentry>
	<term>Kernel Debianizzato</term>
	<listitem><para>Pacchetto dei sorgenti del kernel 2.4.20-8 con la patch di maxx gi&agrave; applicata. Per ulteriori
	informazioni si legga la <link linkend="debianizedkernel">nota di maxx</link>.
	<ulink url="http://people.debian.org/~maxx/kernel-source-2.4.20/">
		http://people.debian.org/~maxx/kernel-source-2.4.20/
	</ulink>
	</para></listitem>
	</varlistentry>

	<varlistentry>
	<term>Patch ACPI</term>
	<listitem><para>&Egrave; necessario scegliere la versione che corrisponde esattamente al kernel che si
	sta utilizzando.
	<ulink url="http://sourceforge.net/project/showfiles.php?group_id=36832">
		http://sourceforge.net/project/showfiles.php?group_id=36832
	</ulink>
	</para></listitem>
	</varlistentry>

	<varlistentry>
	<term><application>acpid</application></term>
	<listitem><para>il demone
	<ulink url="http://sourceforge.net/projects/acpid">
		http://sourceforge.net/projects/acpid
	</ulink>
	</para></listitem>
	</varlistentry>

	<varlistentry>
	<term><application>acpi</application></term>
	<listitem><para>interfaccia testuale
	<ulink url="http://grahame.angrygoats.net/acpi.shtml">
		http://grahame.angrygoats.net/acpi.shtml
	</ulink>
	</para></listitem>
	</varlistentry>

	<varlistentry>
	<term><application>Kacpi</application></term>
	<listitem><para>interfaccia grafica per KDE
	<ulink url="http://www.elektronikschule.de/~genannt/kacpi/download.html">
		http://www.elektronikschule.de/~genannt/kacpi/download.html
	</ulink>
	</para></listitem>
	</varlistentry>

	<varlistentry>
	<term><application>aKpi</application></term>
	<listitem><para>un'altra interfaccia per KDE
	<ulink url="http://akpi.scmd.at/">
		http://akpi.scmd.at/
	</ulink>
	</para></listitem>
	</varlistentry>

	<varlistentry>
	<term><application>wmacpi</application></term>
	<listitem><para>WindowMaker DockApp (un'altra GUI)
	<ulink url="http://www.ne.jp/asahi/linux/timecop/">
		http://www.ne.jp/asahi/linux/timecop/
	</ulink>
	</para></listitem>
	</varlistentry>

	<varlistentry>
	<term><application>wmacpi+clecourt</application></term>
	<listitem><para>WindowMaker DockApp (un'altra interfaccia grafica). Gestisce due
	slot per batterie.
	<ulink url="http://open.iliad.fr/~clecourt/wmacpi/index.html">
		http://open.iliad.fr/~clecourt/wmacpi/index.html
	</ulink>
	</para></listitem>
	</varlistentry>
</variablelist>
</sect1>

<sect1 id="thanks">
<title>Ringraziamenti</title>
<para>Molti ringraziamenti vanno a:</para>
<itemizedlist>

<listitem><para>
<ulink url="http://acpi.sourceforge.net/mailinglists.html">acpi-support</ulink>
(nota: la lista di discussione su ACPI4Linux &egrave; ora in acpi-devel)
</para></listitem>

<listitem><para>
	<ulink url="http://lists.debian.org/debian-laptop/">debian-laptop</ulink>
</para></listitem>

<listitem><para>
<ulink url="http://lists.debian.org/debian-user/">debian-user</ulink>
</para></listitem>

<listitem><para>
<ulink url="http://linuxchix.org/">techtalk</ulink>
</para></listitem>

<listitem><para>
<ulink url="http://www.tldp.org/mailinfo.html#maillists">TLDP mailing
lists</ulink> (discussioni e DocBook)
</para></listitem>

<listitem><para>Sebastian Henschel per avermi ricordato la promessa di redigere il documento</para></listitem>

<listitem><para>Erich Schubert per aver scritto la sezione sul DSDT
</para></listitem>

<listitem><para>Werner Heuser per avermi suggerito di sottoporre il documento al
LDP</para></listitem>

<listitem><para>Tabatha Marshall per l'impaginazione ed in generale per essere stata entusiasta
di imparare DocBook</para></listitem>
</itemizedlist>
</sect1>

<!-- tradurre questa appendice Linee 1097 - 1164 -->
<appendix id="patch">
<title>Applicare patch ai vecchi kernel</title>
<para>Se si sta utilizzando un kernel della serie 2.4.x, sar&agrave; necessaria una patch
prima di poter aggiungere il supporto ACPI. Nonostante ACPI sia incluso nei kernel della serie 2.6.x,
si dovrebbe sempre verificare se sono state rilasciate patch per correggere eventuali bachi.
Questa informazione &egrave; disponibile sul sito di ACPI4Linux.</para>

<sect1>
<title>Recuperare i file sorgenti</title>
<para>Scaricare un nuovo kernel da <ulink
url="http://www.kernel.org">www.kernel.org</ulink>. Assicurarsi di aver scaricato un
kernel completo. Si cerchi <quote>l'ultima versione stabile del kernel Linux</quote>
e si selezioni l'opzione <option>F</option> per FULL (NdT. completo).
Si attenda pazientemente. Un kernel compresso con bzip
occupa circa 26M. Se vi sentite particolarmente confidenti, potete anche eseguire
	<command>wget</command>
	<filename>http://kernel.org/pub/linux/kernel/v2.4/linux-&kernel-version;.tar.bz2</filename>.
</para>

<tip><para>Potreste volere o meno l'ultima versione stabile. Per maggiori informazioni
si legga la sezione <xref linkend="kernelchoice" /> di questo documento.
Se si decide di utilizzare una versione del kernel che non &egrave; pubblicata sulla pagina
principale, si cerchi nella directory <ulink url="http://www.kernel.org/pub/linux/kernel/">/pub/linux/kernel</ulink>
sul sito <ulink url="http://www.kernel.org">kernel.org</ulink>
il kernel desiderato.</para></tip>

<para>Mentre aspettate, procuratevi anche una copia della patch. Per il kernel 2.4.20
si usi la patch <ulink
url="http://prdownloads.sourceforge.net/acpi/acpi-20021212-2.4.20.diff.gz?download">2.4.20</ulink>.
&Egrave; datata 2002.12.12. Questo numero sar&agrave; necessario in seguito, quando si verificher&agrave; che la
patch funzioni. Se si sta impiegando una versione del kernel differente, ci si assicuri di prendere
nota della data della patch corrispondente. I vostri numeri potranno essere sensibilmente diversi
da quelli che io utilizzer&ograve; di qui in avanti.</para>

<para>Una volta ottenuti i due file (il kernel e la patch) li si decomprima e si applichi la patch
al kernel.</para>


<sect2 id="kernelpatch">
<title>Applicare la patch</title>
<para>A questo punto si applicher&agrave; effettivamente la patch al kernel. Ho eseguito un passo in pi&ugrave;
rispetto <ulink url="http://acpi.sourceforge.net/download.html">alle istruzioni</ulink> sul sito di
ACPI4Linux. Invece di eseguire gunzip e patch sulla stessa linea di comando, ne ho impiegate due.
Solo una questione di gusti. Quando si applica una patch al kernel, si potrebbe voler
verificare che non vi siano messaggi di errore (non c'&egrave; un messaggio <quote>tutto bene</quote>, occorre
invece verificare l'assenza di messaggi di errore).</para>
<itemizedlist>
	<listitem><para>
		<command>cd
		<filename class="directory">/usr/src/linux</filename></command>
	</para></listitem>


	<listitem><para>
		<command>cp
		<filename>acpi-20021212-2.4.20.diff.gz</filename>
		<filename>/usr/src/linux/.</filename>
		</command>
		(Il nome del file della patch potrebbe essere differente se non si sta utilizzando il kernel
		2.4.20)
	</para></listitem>

	<listitem><para>
		<command>gunzip
		<filename>acpi-20021212-2.4.20.diff.gz</filename></command>
	</para></listitem>

	<listitem><para>
		<command>patch <option>-p<parameter>1</parameter></option> &lt;
		<filename>acpi-20021212-2.4.20.diff</filename>
		</command>
	 (questa &egrave; la fase della effettiva applicazione della patch)
	</para></listitem>
</itemizedlist>

<para>Una volta terminata l'applicazione della patch, si continui la lettura alla sezione <xref
linkend="kernelconfig"/>.
</para>

</sect2>
</sect1>
</appendix>

<appendix id="nodebkernel">
<title>ACPI: il modo Non-Debian </title>
<para>Ci sono poche e piccole differenze tra il Modo Debian e quello generica. Probabilmente solo
circa 10 linee di differenza.</para>

<sect1 id="nodebcompile">
<title>Compilare il kernel</title>
<para>Il modo <quote>normale</quote> di compilare il kernel non utilizza il comando <command>make-kpkg</command>. Segue invece i seguenti passi:</para>
<itemizedlist>
	<listitem><para>
		<command>cd
		<filename class="directory">/usr/src/linux</filename>
		</command> che dovrebbe puntare ai file (decompressi) del kernel 2.4.20
	</para></listitem>

	<listitem><para>
		<command>make <parameter>dep</parameter></command>
	</para></listitem>

	<listitem><para>
		<command>make <parameter>clean</parameter></command>
	</para></listitem>

	<listitem><para>
		<command>make <parameter>bzImage</parameter></command>
	</para></listitem>

	<listitem><para>
		<command>make <parameter>modules</parameter></command>
		(ricordarsi prima di scompattare i propri moduli)
	</para></listitem>
</itemizedlist>
</sect1>

<sect1 id="nodebinstall">
<title>Installare il nuovo kernel</title>
<para>Secondo il <citetitle>Modo Debian</citetitle>, si crea un file deb che contiene le informazioni sulla posizione
del kernel (e compila il kernel e tutto il resto). Secondo il modo <quote>normal</quote>, si devono mettere le cose
al posto giusto. Si devono installare i moduli e quindi configurare lilo affinch&eacute; punti al
nuovo kernel, infine lanciare lilo. Se non si sta seguendo il <citetitle>Modo Debian</citetitle>, la propria <quote>installazione</quote> risulter&agrave; come segue</para>
<itemizedlist>
	<listitem><para>
		<command>cd
		<filename class="directory">/usr/src/linux</filename>
		</command>
	</para></listitem>

	<listitem><para>
		<command>make
		<parameter>modules_install</parameter></command>
	</para></listitem>

	<listitem><para>
		<command>cp
		<filename>arch/i386/boot/bzImage</filename>
		<filename>/boot/vmlinuz.&kernel-name;</filename>
		</command>
	</para></listitem>

	<listitem><para>
	<command>vi <filename>/etc/lilo.conf</filename></command> e si copi la struttura del
	kernel gi&agrave; installato. NON si devono cancellare i riferimenti al kernel esistente! Lilo deve
	puntare al file <quote>vmlinuz</quote> che &egrave; stato creato durante la compilazione del kernel
	</para></listitem>

	<listitem><para><command>lilo</command> (esattamente nello stesso modo.)
	Lilo mostrer&agrave; dei messaggi se incontrer&egrave; gravi problemi per caricare il nuovo kernel.
	</para></listitem>
</itemizedlist>

<warning>
<para>NON bisogna dimenticare di lanciare lilo prima del riavvio. Si digiti
<command>lilo</command>. &Egrave; cos&igrave; facile (e cos&igrave; facile da dimenticare).</para>
</warning>
</sect1>

<sect1 id="nodebsoftware">
<title>Pacchetti software </title>
<para>Si pu&ograve; utilizzare tutto il software menzionato in questo HOWTO anche se
non si sta utilizzando Debian. Sfortunatamente ci&ograve; richieder&agrave; un piccolo sforzo 
da parte vostra per scaricare ed installare ogni cosa. Fortunatamente non &egrave; cos&igrave; difficile.
La maggior parte dei pacchetti software, una volta scompattati, contengono un file README
che indica di cosa si ha bisogno e cosa fare per far funzionare le cose sul proprio sistema.</para>

&resources-software;
</sect1>
</appendix>

<appendix id="gfdl">
<title>GNU Free Documentation License</title>
<!-- - GNU Project - Free Software Foundation (FSF) -->
<!-- LINK REV="made" HREF="mailto:webmasters@gnu.org" -->
<!-- http://www.gnu.org/copyleft/fdl.html -->


  <!-- sect1>
    <title>GNU Free Documentation License</title -->

    <para>Version 1.1, March 2000</para>

    <blockquote>
      <para>Copyright (C) 2000  Free Software Foundation, Inc.
59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
Everyone is permitted to copy and distribute verbatim copies
of this license document, but changing it is not allowed.</para>
    </blockquote>

  <sect1 id="gfdl-0">
    <title>PREAMBLE</title>

    <para>The purpose of this License is to make a manual, textbook,
    or other written document "free" in the sense of freedom: to
    assure everyone the effective freedom to copy and redistribute it,
    with or without modifying it, either commercially or
    noncommercially.  Secondarily, this License preserves for the
    author and publisher a way to get credit for their work, while not
    being considered responsible for modifications made by
    others.</para>

    <para>This License is a kind of "copyleft", which means that
    derivative works of the document must themselves be free in the
    same sense.  It complements the GNU General Public License, which
    is a copyleft license designed for free software.</para>

    <para>We have designed this License in order to use it for manuals
    for free software, because free software needs free documentation:
    a free program should come with manuals providing the same
    freedoms that the software does.  But this License is not limited
    to software manuals; it can be used for any textual work,
    regardless of subject matter or whether it is published as a
    printed book.  We recommend this License principally for works
    whose purpose is instruction or reference.</para>
  </sect1>

  <sect1 id="gfdl-1">
    <title>APPLICABILITY AND DEFINITIONS</title>

    <para>This License applies to any manual or other work that
    contains a notice placed by the copyright holder saying it can be
    distributed under the terms of this License.  The "Document",
    below, refers to any such manual or work.  Any member of the
    public is a licensee, and is addressed as "you".</para>

    <para>A "Modified Version" of the Document means any work
    containing the Document or a portion of it, either copied
    verbatim, or with modifications and/or translated into another
    language.</para>

    <para>A "Secondary Section" is a named appendix or a front-matter
    section of the Document that deals exclusively with the
    relationship of the publishers or authors of the Document to the
    Document's overall subject (or to related matters) and contains
    nothing that could fall directly within that overall subject.
    (For example, if the Document is in part a textbook of
    mathematics, a Secondary Section may not explain any mathematics.)
    The relationship could be a matter of historical connection with
    the subject or with related matters, or of legal, commercial,
    philosophical, ethical or political position regarding
    them.</para>

    <para>The "Invariant Sections" are certain Secondary Sections
    whose titles are designated, as being those of Invariant Sections,
    in the notice that says that the Document is released under this
    License.</para>

    <para>The "Cover Texts" are certain short passages of text that
    are listed, as Front-Cover Texts or Back-Cover Texts, in the
    notice that says that the Document is released under this
    License.</para>

    <para>A "Transparent" copy of the Document means a
    machine-readable copy, represented in a format whose specification
    is available to the general public, whose contents can be viewed
    and edited directly and straightforwardly with generic text
    editors or (for images composed of pixels) generic paint programs
    or (for drawings) some widely available drawing editor, and that
    is suitable for input to text formatters or for automatic
    translation to a variety of formats suitable for input to text
    formatters.  A copy made in an otherwise Transparent file format
    whose markup has been designed to thwart or discourage subsequent
    modification by readers is not Transparent.  A copy that is not
    "Transparent" is called "Opaque".</para>

    <para>Examples of suitable formats for Transparent copies include
    plain ASCII without markup, Texinfo input format, LaTeX input
    format, SGML or XML using a publicly available DTD, and
    standard-conforming simple HTML designed for human modification.
    Opaque formats include PostScript, PDF, proprietary formats that
    can be read and edited only by proprietary word processors, SGML
    or XML for which the DTD and/or processing tools are not generally
    available, and the machine-generated HTML produced by some word
    processors for output purposes only.</para>

    <para>The "Title Page" means, for a printed book, the title page
    itself, plus such following pages as are needed to hold, legibly,
    the material this License requires to appear in the title page.
    For works in formats which do not have any title page as such,
    "Title Page" means the text near the most prominent appearance of
    the work's title, preceding the beginning of the body of the
    text.</para>
  </sect1>

  <sect1 id="gfdl-2">
    <title>VERBATIM COPYING</title>

    <para>You may copy and distribute the Document in any medium,
    either commercially or noncommercially, provided that this
    License, the copyright notices, and the license notice saying this
    License applies to the Document are reproduced in all copies, and
    that you add no other conditions whatsoever to those of this
    License.  You may not use technical measures to obstruct or
    control the reading or further copying of the copies you make or
    distribute.  However, you may accept compensation in exchange for
    copies.  If you distribute a large enough number of copies you
    must also follow the conditions in section 3.</para>

    <para>You may also lend copies, under the same conditions stated
    above, and you may publicly display copies.</para>
  </sect1>

  <sect1 id="gfdl-3">
    <title>COPYING IN QUANTITY</title>

    <para>If you publish printed copies of the Document numbering more
    than 100, and the Document's license notice requires Cover Texts,
    you must enclose the copies in covers that carry, clearly and
    legibly, all these Cover Texts: Front-Cover Texts on the front
    cover, and Back-Cover Texts on the back cover.  Both covers must
    also clearly and legibly identify you as the publisher of these
    copies.  The front cover must present the full title with all
    words of the title equally prominent and visible.  You may add
    other material on the covers in addition.  Copying with changes
    limited to the covers, as long as they preserve the title of the
    Document and satisfy these conditions, can be treated as verbatim
    copying in other respects.</para>

    <para>If the required texts for either cover are too voluminous to
    fit legibly, you should put the first ones listed (as many as fit
    reasonably) on the actual cover, and continue the rest onto
    adjacent pages.</para>

    <para>If you publish or distribute Opaque copies of the Document
    numbering more than 100, you must either include a
    machine-readable Transparent copy along with each Opaque copy, or
    state in or with each Opaque copy a publicly-accessible
    computer-network location containing a complete Transparent copy
    of the Document, free of added material, which the general
    network-using public has access to download anonymously at no
    charge using public-standard network protocols.  If you use the
    latter option, you must take reasonably prudent steps, when you
    begin distribution of Opaque copies in quantity, to ensure that
    this Transparent copy will remain thus accessible at the stated
    location until at least one year after the last time you
    distribute an Opaque copy (directly or through your agents or
    retailers) of that edition to the public.</para>

    <para>It is requested, but not required, that you contact the
    authors of the Document well before redistributing any large
    number of copies, to give them a chance to provide you with an
    updated version of the Document.</para>
  </sect1>

  <sect1 id="gfdl-4">
    <title>MODIFICATIONS</title>

    <para>You may copy and distribute a Modified Version of the
    Document under the conditions of sections 2 and 3 above, provided
    that you release the Modified Version under precisely this
    License, with the Modified Version filling the role of the
    Document, thus licensing distribution and modification of the
    Modified Version to whoever possesses a copy of it.  In addition,
    you must do these things in the Modified Version:</para>

    <orderedlist numeration="upperalpha">
      <listitem><para>Use in the Title Page
      (and on the covers, if any) a title distinct from that of the
      Document, and from those of previous versions (which should, if
      there were any, be listed in the History section of the
      Document).  You may use the same title as a previous version if
      the original publisher of that version gives permission.</para>
      </listitem>

      <listitem><para>List on the Title Page,
      as authors, one or more persons or entities responsible for
      authorship of the modifications in the Modified Version,
      together with at least five of the principal authors of the
      Document (all of its principal authors, if it has less than
      five).</para>
      </listitem>

      <listitem><para>State on the Title page
      the name of the publisher of the Modified Version, as the
      publisher.</para>
      </listitem>

      <listitem><para>Preserve all the
      copyright notices of the Document.</para>
      </listitem>

      <listitem><para>Add an appropriate
      copyright notice for your modifications adjacent to the other
      copyright notices.</para>
      </listitem>

      <listitem><para>Include, immediately
      after the copyright notices, a license notice giving the public
      permission to use the Modified Version under the terms of this
      License, in the form shown in the Addendum below.</para>
      </listitem>

      <listitem><para>Preserve in that license
      notice the full lists of Invariant Sections and required Cover
      Texts given in the Document's license notice.</para>
      </listitem>

      <listitem><para>Include an unaltered
      copy of this License.</para>
      </listitem>

      <listitem><para>Preserve the section
      entitled "History", and its title, and add to it an item stating
      at least the title, year, new authors, and publisher of the
      Modified Version as given on the Title Page.  If there is no
      section entitled "History" in the Document, create one stating
      the title, year, authors, and publisher of the Document as given
      on its Title Page, then add an item describing the Modified
      Version as stated in the previous sentence.</para>
      </listitem>

      <listitem><para>Preserve the network
      location, if any, given in the Document for public access to a
      Transparent copy of the Document, and likewise the network
      locations given in the Document for previous versions it was
      based on.  These may be placed in the "History" section.  You
      may omit a network location for a work that was published at
      least four years before the Document itself, or if the original
      publisher of the version it refers to gives permission.</para>
      </listitem>

      <listitem><para>In any section entitled
      "Acknowledgements" or "Dedications", preserve the section's
      title, and preserve in the section all the substance and tone of
      each of the contributor acknowledgements and/or dedications
      given therein.</para>
      </listitem>

      <listitem><para>Preserve all the
      Invariant Sections of the Document, unaltered in their text and
      in their titles.  Section numbers or the equivalent are not
      considered part of the section titles.</para>
      </listitem>

      <listitem><para>Delete any section
      entitled "Endorsements".  Such a section may not be included in
      the Modified Version.</para>
      </listitem>

      <listitem><para>Do not retitle any
      existing section as "Endorsements" or to conflict in title with
      any Invariant Section.</para>
      </listitem>
    </orderedlist>

    <para>If the Modified Version includes new front-matter sections
    or appendices that qualify as Secondary Sections and contain no
    material copied from the Document, you may at your option
    designate some or all of these sections as invariant.  To do this,
    add their titles to the list of Invariant Sections in the Modified
    Version's license notice.  These titles must be distinct from any
    other section titles.</para>

    <para>You may add a section entitled "Endorsements", provided it
    contains nothing but endorsements of your Modified Version by
    various parties--for example, statements of peer review or that
    the text has been approved by an organization as the authoritative
    definition of a standard.</para>

    <para>You may add a passage of up to five words as a Front-Cover
    Text, and a passage of up to 25 words as a Back-Cover Text, to the
    end of the list of Cover Texts in the Modified Version.  Only one
    passage of Front-Cover Text and one of Back-Cover Text may be
    added by (or through arrangements made by) any one entity.  If the
    Document already includes a cover text for the same cover,
    previously added by you or by arrangement made by the same entity
    you are acting on behalf of, you may not add another; but you may
    replace the old one, on explicit permission from the previous
    publisher that added the old one.</para>

    <para>The author(s) and publisher(s) of the Document do not by
    this License give permission to use their names for publicity for
    or to assert or imply endorsement of any Modified Version.</para>
  </sect1>

  <sect1 id="gfdl-5">
    <title>COMBINING DOCUMENTS</title>

    <para>You may combine the Document with other documents released
    under this License, under the terms defined in section 4 above for
    modified versions, provided that you include in the combination
    all of the Invariant Sections of all of the original documents,
    unmodified, and list them all as Invariant Sections of your
    combined work in its license notice.</para>

    <para>The combined work need only contain one copy of this
    License, and multiple identical Invariant Sections may be replaced
    with a single copy.  If there are multiple Invariant Sections with
    the same name but different contents, make the title of each such
    section unique by adding at the end of it, in parentheses, the
    name of the original author or publisher of that section if known,
    or else a unique number.  Make the same adjustment to the section
    titles in the list of Invariant Sections in the license notice of
    the combined work.</para>

    <para>In the combination, you must combine any sections entitled
    "History" in the various original documents, forming one section
    entitled "History"; likewise combine any sections entitled
    "Acknowledgements", and any sections entitled "Dedications".  You
    must delete all sections entitled "Endorsements."</para>
  </sect1>

  <sect1 id="gfdl-6">
    <title>COLLECTIONS OF DOCUMENTS</title>

    <para>You may make a collection consisting of the Document and
    other documents released under this License, and replace the
    individual copies of this License in the various documents with a
    single copy that is included in the collection, provided that you
    follow the rules of this License for verbatim copying of each of
    the documents in all other respects.</para>

    <para>You may extract a single document from such a collection,
    and distribute it individually under this License, provided you
    insert a copy of this License into the extracted document, and
    follow this License in all other respects regarding verbatim
    copying of that document.</para>
  </sect1>

  <sect1 id="gfdl-7">
    <title>AGGREGATION WITH INDEPENDENT WORKS</title>

    <para>A compilation of the Document or its derivatives with other
    separate and independent documents or works, in or on a volume of
    a storage or distribution medium, does not as a whole count as a
    Modified Version of the Document, provided no compilation
    copyright is claimed for the compilation.  Such a compilation is
    called an "aggregate", and this License does not apply to the
    other self-contained works thus compiled with the Document, on
    account of their being thus compiled, if they are not themselves
    derivative works of the Document.</para>

    <para>If the Cover Text requirement of section 3 is applicable to
    these copies of the Document, then if the Document is less than
    one quarter of the entire aggregate, the Document's Cover Texts
    may be placed on covers that surround only the Document within the
    aggregate.  Otherwise they must appear on covers around the whole
    aggregate.</para>
  </sect1>

  <sect1 id="gfdl-8">
    <title>TRANSLATION</title>

    <para>Translation is considered a kind of modification, so you may
    distribute translations of the Document under the terms of section
    4.  Replacing Invariant Sections with translations requires
    special permission from their copyright holders, but you may
    include translations of some or all Invariant Sections in addition
    to the original versions of these Invariant Sections.  You may
    include a translation of this License provided that you also
    include the original English version of this License.  In case of
    a disagreement between the translation and the original English
    version of this License, the original English version will
    prevail.</para>
  </sect1>

  <sect1 id="gfdl-9">
    <title>TERMINATION</title>

    <para>You may not copy, modify, sublicense, or distribute the
    Document except as expressly provided for under this License.  Any
    other attempt to copy, modify, sublicense or distribute the
    Document is void, and will automatically terminate your rights
    under this License.  However, parties who have received copies, or
    rights, from you under this License will not have their licenses
    terminated so long as such parties remain in full
    compliance.</para>
  </sect1>

  <sect1 id="gfdl-10">
    <title>FUTURE REVISIONS OF THIS LICENSE</title>

    <para>The Free Software Foundation may publish new, revised
    versions of the GNU Free Documentation License from time to time.
    Such new versions will be similar in spirit to the present
    version, but may differ in detail to address new problems or
    concerns.  See <ulink
    url="http://www.gnu.org/copyleft/">http://www.gnu.org/copyleft/</ulink>.</para>

    <para>Each version of the License is given a distinguishing
    version number.  If the Document specifies that a particular
    numbered version of this License "or any later version" applies to
    it, you have the option of following the terms and conditions
    either of that specified version or of any later version that has
    been published (not as a draft) by the Free Software Foundation.
    If the Document does not specify a version number of this License,
    you may choose any version ever published (not as a draft) by the
    Free Software Foundation.</para>
  </sect1>

  <sect1 id="gfdl-11">
    <title>How to use this License for your documents</title>

    <para>To use this License in a document you have written, include
    a copy of the License in the document and put the following
    copyright and license notices just after the title page:</para>

<blockquote><para>
      Copyright (c)  YEAR  YOUR NAME.
      Permission is granted to copy, distribute and/or modify this document
      under the terms of the GNU Free Documentation License, Version 1.1
      or any later version published by the Free Software Foundation;
      with the Invariant Sections being LIST THEIR TITLES, with the
      Front-Cover Texts being LIST, and with the Back-Cover Texts being LIST.
      A copy of the license is included in the section entitled "GNU
      Free Documentation License".
</para></blockquote>

    <para>If you have no Invariant Sections, write "with no Invariant
    Sections" instead of saying which ones are invariant.  If you have
    no Front-Cover Texts, write "no Front-Cover Texts" instead of
    "Front-Cover Texts being LIST"; likewise for Back-Cover
    Texts.</para>

    <para>If your document contains nontrivial examples of program
    code, we recommend releasing these examples in parallel under your
    choice of free software license, such as the GNU General Public
    License, to permit their use in free software.</para>
  </sect1>

</appendix>

</article>


