Appendice A. Dove trovare ulteriore documentazione

Sommario
A.1. La documentazione inclusa in Linux-Mandrake
A.1.1. Le pagine di manuale (pagine "man")
A.1.2. Pagine Info
A.1.3. Gli HOWTO
A.1.4. La directory /usr/share/doc
A.2. Internet
A.2.1. Siti web dedicati a Linux
A.2.2. Mailing list
A.2.3. I gruppi di discussione
A.3. Linee guida generali per la soluzione di problemi con Linux-Mandrake
A.3.1. RTFM
A.3.2. Ricerche su Internet
A.3.3. Archivi di mailing list e gruppi di discussione
A.3.4. Domande su mailing list e gruppi di discussione
A.3.5. Contattare direttamente il responsabile

Oltre ai manuali inclusi in Linux-Mandrake, esistono molte altre fonti di documentazione. Nelle pagine seguenti vi daremo alcuni suggerimenti che potreste trovare utili.

A.1. La documentazione inclusa in Linux-Mandrake

A.1.1. Le pagine di manuale (pagine "man")

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.

I contenuti delle pagine "man" sono divisi in sezioni; i riferimenti alle sezioni vengono espressi come nei seguenti esempi: open(2), fstab(5), i quali indicano rispettivamente la pagina di manuale di open nella sezione 2 e la pagina di manuale di fstab nella sezione 5.

Il comando per mostrare una pagina di manuale è man, e la sua sintassi è la seguente:
man [opzioni] [sezione] <pagina di manuale>
Anche lo stesso man ha una propria pagina di manuale: man man. Normalmente le pagine di manuale vengono impaginate e poi mostrate tramite il visualizzatore less; quindi sapete già come sfogliare una pagina di manuale e come uscirne :-).

In cima ad ogni pagina di manuale potete vederne indicati il nome e la relativa sezione; in fondo alla pagina (in genere nella sezione VEDERE ANCHE), invece, troverete eventuali riferimenti ad altre pagine di manuale correlate con quella che state leggendo.

Potete iniziare consultando le pagine dei diversi comandi che sono stati menzionati in questo manuale: ls(1), chmod(1), etc.

Se non trovate la pagina di manuale che state cercando (ad esempio, se volete usare la funzione mknod in uno dei vostri programmi, e invece finite sempre nella pagina di manuale del comando mknod), dovete indicare esplicitamente la sezione, ad esempio nel caso appena citato: mknod(2); se non ricordate il numero esatto della sezione, il comando man -a mknod analizzerà tutte le sezioni in cerca di pagine di manuale di nome mknod.

A.1.2. Pagine Info

Le pagine info completano la documentazione messa a disposizione dalle pagine di manuale. Il comando per accedere alle pagine info è info.

Le pagine info sono organizzate secondo una struttura ad albero, la cui sommità è denominata dir. Dalla sommità potete accedere a tutte le pagine info esistenti.

Potete richiamare info 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:
info emacs
Nelle pagine info un testo come questo:
* Buffers::
indica un collegamento; se spostate il cursore su questo collegamento (usando i tasti cursore) e premete Invio, sarete portati alla pagina info corrispondente.

Potete usare le seguenti scorciatoie da tastiera:

  • u: per Up, va al livello superiore;

  • n: per Next, va alla pagina info successiva nel livello attuale della struttura ad albero;

  • p: per Prev, va alla pagina info precedente.

Sono disponibili molti comandi, che possono essere elencati digitando ?.

A.1.3. Gli HOWTO

Gli HOWTO sono documenti pubblicati dal LDP (Linux Documentation Project), sono disponibili in molte lingue e sono dedicati alla configurazione di molti aspetti del vostro sistema. Se avete installato il pacchetto corrispondente (per l'edizione italiana è il pacchetto howto-html-it), avete buone probabilità di trovare sul vostro disco rigido il documento che contiene la risposta a una particolare domanda o la soluzione di un problema. Questi documenti si trovano nella directory /usr/share/doc/HOWTO/HTML/it/. Il loro formato principale è il testo semplice, ma sono disponibili anche in HTML per la lettura con un browser web, e in PostScript per la stampa.

L'elenco è molto lungo; per averne un'idea consultate l'indice scegliendo dal menu principale: Documentazione->Howtos Italian. Se incontrate un problema che non siete in grado di risolvere, il modo migliore per affrontarlo è cercare e leggere, se esiste, il relativo HOWTO, 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 (NET-3-HOWTO), la configurazione della scheda audio (Sound-HOWTO), la creazione di CD (CD-Writing-HOWTO), la configurazione di NIS e NFS, e molte altre cose.

È importante controllare la data dell'ultima modifica dei documenti HOWTO - 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 HOWTO riguardanti la configurazione hardware, poiché quello è un campo in cui GNU/Linux si evolve molto rapidamente. Ricordate anche che il significato del termine "vecchio" 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.

Nota

Gli HOWTO sono disponibili in linea, in forma probabilmente più aggiornata, sul sito del LDP. Date anche un'occhiata ai seguenti indirizzi: (ordinati per categoria); e FAQ.

A.1.4. La directory /usr/share/doc

Alcuni pacchetti sono corredati da una propria documentazione, che si trova in una sotto-directory di /usr/share/doc e ha lo stesso nome del pacchetto in questione.


Tux on Star from MandrakeSoft Linux è un marchio registrato di Linus Torvalds. Tutti gli altri marchi e copyright appartengono ai rispettivi proprietari.
Se non diversamente specificato, i diritti di tutto il contenuto di queste pagine e di tutte le immagini sono proprietà di MandrakeSoft S.A. e MandrakeSoft Inc. 2000.
http://www.linux-mandrake.com/