<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>