<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>La documentazione inclusa in Mandrakelinux</title><meta name="generator" content="DocBook XSL Stylesheets V1.64.0"><link rel="home" href="index.html" title="Guida rapida"><link rel="up" href="get-doc-chapter.html" title="Capitolo 6. Dove trovare ulteriore documentazione"><link rel="previous" href="get-doc-chapter.html" title="Capitolo 6. Dove trovare ulteriore documentazione"><link rel="next" href="ch06s02.html" title="Internet"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">La documentazione inclusa in Mandrakelinux</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="get-doc-chapter.html">Indietro</a> </td><th width="60%" align="center">Capitolo 6. Dove trovare ulteriore documentazione</th><td width="20%" align="right"> <a accesskey="n" href="ch06s02.html">Avanti</a></td></tr></table><hr></div><div class="sect1" lang="it"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id2542545"></a>La documentazione inclusa in Mandrakelinux</h2></div></div><div></div></div><div class="sect2" lang="it"><div class="titlepage"><div><div><h3 class="title"><a name="id2542557"></a>La documentazione
Mandrakesoft</h3></div></div><div></div></div><p><a name="BId-get-doc-chapter-pa2"></a>
Elenchiamo qui di seguito tutta la documentazione prodotta
dalla <span class="emphasis"><em>Mandrakesoft</em></span> per la versione corrente di
<span class="application">Mandrakelinux</span>:</p><div class="itemizedlist"><ul type="disc"><li><p><a name="BId-get-doc-chapter-pa3"></a>Potete
consultare le versioni aggiornate di questi manuali su
Internet, visitando le <a href="http://www.mandrakelinux.com/it/fdoc.php3" target="_top">pagine della
documentazione</a>.
</p><p><a name="BId-get-doc-chapter-pa4"></a>Se durante
l'installazione avete selezionato il gruppo di pacchetti della
documentazione, scegliendo
<span class="guimenuitem">Leggi la
documentazione</span> dal menu principale
potrete vedere tutta la documentazione relativa alle lingue da
voi scelte durante l'installazione.</p></li><li><p><a name="BId-get-doc-chapter-pa7"></a><i class="citetitle">Guida introduttiva</i></p><p><a name="BId-get-doc-chapter-pa8"></a>Questo manuale
ha lo scopo di farvi prendere confidenza con <span class="application">Mandrakelinux</span> e
iniziare a usare il sistema. Pertanto tratta di nozioni di
base, utili per i nuovi utenti <span class="application">GNU/Linux</span>, e spiega come
configurare gli aspetti più importanti del sistema. </p></li><li><p><a name="BId-get-doc-chapter-pa9"></a><i class="citetitle">Guida alla linea di comando</i></p><p><a name="BId-get-doc-chapter-pa10"></a>Questo manuale,
disponibile online e nella versione <span class="productname">Mandrakelinux – Edizione PowerPack</span>™, affronta
argomenti come l'amministrazione del sistema e altre operazioni
complesse su <span class="application">GNU/Linux</span>.</p></li><li><p><a name="BIdNEW-get-doc-chapter-pa70"></a><i class="citetitle">Guida rapida per la configurazione del server</i></p><p><a name="BIdNEW-get-doc-chapter-pa71"></a>Si occupa
dei più comuni servizi disponibili su Linux, come <span class="acronym">HTTP</span>,
<span class="acronym">FTP</span>, <span class="acronym">POP</span> e <span class="acronym">SMTP</span>. È disponibile solo su Internet e su
<span class="acronym">CD</span>.
</p></li></ul></div></div><div class="sect2" lang="it"><div class="titlepage"><div><div><h3 class="title"><a name="id2542783"></a>Le pagine di manuale (pagine
“<span class="quote">man</span>”)</h3></div></div><div></div></div><a class="indexterm" name="BIdNEW-get-doc-chapter-it4"></a><a class="indexterm" name="BIdNEW-get-doc-chapter-it5"></a><p><a name="BId-get-doc-chapter-pa11"></a>Si tratta della
fonte primaria di informazioni nell'uso quotidiano: quasi tutti i
comandi hanno una propria pagina di manuale. Inoltre ci sono anche
pagine di manuale sul formato di alcuni file di configurazione,
sulle funzioni delle librerie per programmatori, e altre
ancora.</p><p><a name="BId-get-doc-chapter-pa12"></a>I contenuti delle pagine “<span class="quote">man</span>” sono divisi in sezioni; i
riferimenti alle sezioni vengono espressi come nei seguenti esempi:
<span class="citerefentry"><span class="refentrytitle"><a name="BId-get-doc-chapter-rt1"></a>open</span>(2)</span>,
<span class="citerefentry"><span class="refentrytitle"><a name="BId-get-doc-chapter-rt2"></a>fstab</span>(5)</span>, i quali
indicano rispettivamente la pagina di manuale di
<span><b class="command">open</b></span> nella sezione 2 e la pagina di manuale di
<span><b class="command">fstab</b></span> nella sezione 5.</p><p><a name="BId-get-doc-chapter-pa13"></a>
Il comando da terminale (o da <tt class="systemitem">shell</tt>) per mostrare una
pagina di manuale è <span><b class="command">man</b></span>, e la sua sintassi
è la seguente:
<a name="BId-get-doc-chapter-sc1"></a></p><table border="0" bgcolor="#E0E0E0"><tr><td><pre class="screen">man [opzioni] [sezione] <pagina di manuale></pre></td></tr></table><p>
Anche lo stesso <span><b class="command">man</b></span> ha una propria pagina di manuale:
<span><b class="command">man man</b></span>. Normalmente le pagine di manuale vengono
impaginate e poi mostrate tramite il <i class="glossterm"><a name="BId-get-doc-chapter-gt1"></a>visualizzatore</i>
<span><b class="command">less</b></span>.</p><p><a name="BId-get-doc-chapter-pa14"></a>In cima ad ogni pagina di manuale potete vederne indicati il nome e la
relativa sezione; in fondo alla pagina (in genere nella sezione
<span class="emphasis"><em>VEDERE ANCHE</em></span>), invece, troverete eventuali riferimenti ad
altre pagine di manuale correlate con quella che state leggendo.</p><p><a name="BId-get-doc-chapter-pa15"></a>Potete iniziare
consultando le pagine dei diversi comandi menzionati nella
<i class="citetitle">Guida alla linea di comando</i>:
<span class="citerefentry"><span class="refentrytitle"><a name="BId-get-doc-chapter-rt3"></a>ls</span>(1)</span>,
<span class="citerefentry"><span class="refentrytitle"><a name="BId-get-doc-chapter-rt4"></a>chmod</span>(1)</span>, etc.
</p><p><a name="BId-get-doc-chapter-pa16"></a>Se non trovate la
pagina di manuale che state cercando (ad esempio, se volete usare
la funzione <tt class="literal">mknod</tt> in un vostro programma, e
finite sempre nella pagina di manuale del comando <span><b class="command">mknod</b></span>),
dovete indicare esplicitamente la sezione. Per esempio, nel caso
appena citato:
<span class="citerefentry"><span class="refentrytitle"><a name="BId-get-doc-chapter-rt5"></a>mknod</span>(2)</span>; se non ricordate il numero esatto della sezione,
il comando <span><b class="command">man -a mknod</b></span> analizzerà tutte le
sezioni in cerca di pagine di manuale di nome
<tt class="literal">mknod</tt>.</p></div><div class="sect2" lang="it"><div class="titlepage"><div><div><h3 class="title"><a name="id2543104"></a>Pagine Info</h3></div></div><div></div></div><p><a name="BId-get-doc-chapter-pa17"></a>Le pagine <span><b class="command">info</b></span> completano la documentazione messa a disposizione
dalle pagine di manuale. Il comando per accedere alle pagine
<span><b class="command">info</b></span> da terminale è <span><b class="command">info</b></span>.</p><p><a name="BId-get-doc-chapter-pa18"></a>Le pagine <span><b class="command">info</b></span> sono organizzate secondo una struttura ad albero,
la cui sommità è denominata <tt class="filename">dir</tt>. Dalla sommità potete
accedere a tutte le pagine <span><b class="command">info</b></span> esistenti.</p><p><a name="BId-get-doc-chapter-pa19"></a>Potete richiamare <span><b class="command">info</b></span> in due modi: senza argomenti, nel qual
caso vi troverete posizionati in cima alla struttura ad albero, oppure
seguito dal nome di un comando o di un pacchetto, e in questo caso sarà
aperta la pagina corrispondente, se esistente. Ad esempio:
<a name="BId-get-doc-chapter-pl1"></a></p><table border="0" bgcolor="#E0E0E0"><tr><td><pre class="programlisting">info emacs</pre></td></tr></table><p>
Nelle pagine <span><b class="command">info</b></span> un testo come questo:
<a name="BId-get-doc-chapter-sc2"></a></p><table border="0" bgcolor="#E0E0E0"><tr><td><pre class="screen">* Buffers::</pre></td></tr></table><p>
indica un collegamento; se spostate il cursore su questo collegamento
(usando i tasti cursore) e premete <b class="userinput"><tt>Invio</tt></b>, sarete portati
alla pagina <span><b class="command">info</b></span> corrispondente.
</p><p><a name="BId-get-doc-chapter-pa20"></a>Potete usare le seguenti scorciatoie da tastiera:</p><div class="itemizedlist"><ul type="disc"><li><p><a name="BId-get-doc-chapter-pa21"></a><span><b class="keycap">u</b></span>: per <span class="foreignphrase"><i class="foreignphrase">Up</i></span>, va al
livello superiore;</p></li><li><p><a name="BId-get-doc-chapter-pa22"></a><span><b class="keycap">n</b></span>: per <span class="foreignphrase"><i class="foreignphrase">Next</i></span>, va alla pagina <span><b class="command">info</b></span>
successiva nel livello attuale della struttura ad albero;
</p></li><li><p><a name="BId-get-doc-chapter-pa23"></a><span><b class="keycap">p</b></span>: per <span class="foreignphrase"><i class="foreignphrase">Prev</i></span>, va alla pagina <span><b class="command">info</b></span>
precedente;
</p></li><li><p><a name="get-doc-chapter-pa27a"></a><span><b class="keycap">q</b></span>: per
<span class="foreignphrase"><i class="foreignphrase">Quit</i></span> (“<span class="quote">Esci</span>”), chiude il
visualizzatore di pagine <span><b class="command">info</b></span>.</p></li></ul></div><p><a name="BId-get-doc-chapter-pa24"></a>Sono disponibili molti comandi, che possono essere elencati digitando
“<span class="quote">?</span>”.</p></div><div class="sect2" lang="it"><div class="titlepage"><div><div><h3 class="title"><a name="id2543370"></a>Gli HOWTO</h3></div></div><div></div></div><p><a name="BId-get-doc-chapter-pa25"></a>Gli <tt class="systemitem">HOWTO</tt>
sono documenti pubblicati dal <span class="acronym">TLDP</span>
(<span class="foreignphrase"><i class="foreignphrase">The Linux Documentation Project</i></span>), sono
disponibili in molte lingue e sono dedicati alla configurazione di
molti aspetti del sistema. Se avete installato il pacchetto
corrispondente (per l'edizione italiana è il pacchetto
<tt class="filename">howto-html-it</tt>), avete buone probabilità di
trovare sul vostro stesso sistema la risposta a una particolare
domanda o la soluzione di un problema. Questi documenti si trovano
nella directory <tt class="filename">/usr/share/doc/HOWTO/HTML/it/</tt>;
sono file in formato <span class="acronym">HTML</span>, leggibili e stampabili tramite un
qualsiasi browser.</p><p><a name="BId-get-doc-chapter-pa26"></a>L'elenco è molto
lungo, per averne un'idea consultate l'indice scegliendo dal menu
principale:
<span class="guimenu">Leggi la documentazione</span>-><span class="guimenuitem">Howto in italiano</span>.
Se incontrate un problema che non siete in grado di risolvere, il modo
migliore per iniziare ad affrontarlo è leggere, se esiste, il relativo
<tt class="systemitem">HOWTO</tt>, ed è molto probabile che non solo troverete la vostra
soluzione, ma imparerete allo stesso tempo anche molte altre cose. Tra
i vari argomenti trattati figurano le reti
(<tt class="filename">NET-3-HOWTO</tt>), la configurazione della scheda
audio (<tt class="filename">Sound-HOWTO</tt>), la creazione di <span class="acronym">CD</span>
(<tt class="filename">CD-Writing-HOWTO</tt>), la configurazione di <span class="acronym">NIS</span> e
<span class="acronym">NFS</span>, e molte altre cose.</p><p><a name="BId-get-doc-chapter-pa27"></a>È importante controllare la data dell'ultima
modifica dei documenti <tt class="systemitem">HOWTO</tt>, ovvero la data di pubblicazione
indicata all'inizio del documento, per essere sicuri che siano
aggiornati, altrimenti è possibile che i relativi contenuti non siano
più affidabili. Fate attenzione in particolare ai vecchi <tt class="systemitem">HOWTO</tt>
riguardanti la configurazione hardware, poiché quello è un campo in
cui <span class="application">Linux</span> si evolve molto rapidamente. Ricordate anche che il
significato del termine “<span class="quote">vecchio</span>” nell'ambito del
software liberamente distribuibile è ancora più forte di quanto lo sia
nel mondo dell'informatica in generale: un programma liberamente
distribuibile a volte è considerato vecchio già quando sono passati
solo 15 giorni dalla sua pubblicazione!</p><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="images/note.png"></td><th align="left">Nota</th></tr><tr><td colspan="2" align="left" valign="top"><p><a name="BId-get-doc-chapter-pa28"></a>Gli <tt class="systemitem">HOWTO</tt>
sono disponibili online, in forma probabilmente più aggiornata,
sul sito del <a href="http://www.tldp.org/" target="_top"><span class="acronym">TLDP</span></a>;
gran parte di essi sono stati tradotti in italiano e si trovano
sul sito <a href="http://ildp.linux.it/" target="_top">ILDP</a> insieme
ad altra documentazione in lingua italiana; ricordatevi di
controllare che la traduzione sia aggiornata. Date anche
un'occhiata ai seguenti indirizzi: <a href="http://www.tldp.org/HOWTO/HOWTO-INDEX/categories.html" target="_top"><tt class="systemitem">HOWTO</tt>
ordinati per categoria</a> e
<a href="http://www.tldp.org/docs.html#faq" target="_top">
<span class="acronym">FAQ</span></a>.</p></td></tr></table></div></div><div class="sect2" lang="it"><div class="titlepage"><div><div><h3 class="title"><a name="id2543631"></a>La directory /usr/share/doc</h3></div></div><div></div></div><p><a name="BId-get-doc-chapter-pa29"></a>Alcuni pacchetti sono corredati da una propria documentazione, che si
trova in una sottodirectory di <tt class="filename">/usr/share/doc</tt> e ha lo
stesso nome del pacchetto in questione.</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="get-doc-chapter.html">Indietro</a> </td><td width="20%" align="center"><a accesskey="u" href="get-doc-chapter.html">Risali</a></td><td width="40%" align="right"> <a accesskey="n" href="ch06s02.html">Avanti</a></td></tr><tr><td width="40%" align="left" valign="top">Capitolo 6. Dove trovare ulteriore documentazione </td><td width="20%" align="center"><a accesskey="h" href="index.html">Partenza</a></td><td width="40%" align="right" valign="top"> Internet</td></tr></table></div></body></html>
