[successivo] [precedente] [inizio] [fine] [indice generale] [indice ridotto] [indice analitico] [volume] [parte]
Esistono diverse fonti di documentazione sui sistemi Unix. La maggior parte di questa è normalmente disponibile all'interno delle distribuzioni, ma la consultazione può risultare un problema per chi non ha esperienza.
Il modo più semplice con cui può essere stato scritto qualcosa è quello del testo puro. Questo è il caso dei file «leggimi» (readme) e simili, oppure di tutta quella documentazione che, per semplicità, è stata convertita anche in tale formato.
La lettura di questi file può essere fatta attraverso due programmi ben conosciuti: more oppure less. Il programma more è quello tradizionalmente più diffuso negli ambienti Unix; less è il più pratico ed è decisamente più ricco di piccoli accorgimenti. Le funzionalità essenziali di questi due programmi sono simili, anche se il secondo offrirebbe un gran numero di funzioni aggiuntive che qui non vengono considerate.
La sintassi di questi due programmi è la seguente:
more [opzioni] [file]... |
less [opzioni] [file]... |
Nell'utilizzo normale non vengono fornite opzioni e se non si indicano file negli argomenti, si ottiene lo scorrimento di quanto proviene dallo standard input:
more [opzioni] < [file] |
less [opzioni] < [file] |
Una volta avviato uno di questi due programmi, lo scorrimento del testo dei file da visualizzare avviene per mezzo di comandi impartiti attraverso la pressione di tasti. Il meccanismo è simile a quello utilizzato da VI: alcuni comandi richiedono semplicemente la pressione di uno o più tasti in sequenza; altri richiedono un argomento e in questo caso, la digitazione appare nell'ultima riga dello schermo o della finestra a disposizione. La tabella 43.1 mostra l'elenco dei comandi comuni ed essenziali di questi due programmi.
|
Tabella 43.1. Elenco dei comandi comuni ed essenziali di more e less. |
La differenza fondamentale tra questi due programmi sta nella possibilità da parte di less di scorrere il testo all'indietro anche quando questo proviene dallo standard input, mentre per more non è possibile. Inoltre less permette di utilizzare i tasti freccia e i tasti pagina per lo scorrimento del testo, consentendo anche di effettuare ricerche all'indietro. La tabella 43.2 mostra l'elenco di alcuni comandi aggiuntivi disponibili con less.
|
Tabella 43.2. Elenco di alcuni comandi particolari di less. |
Il programma less permette un utilizzo molto più complesso di quanto descritto qui, ma questo va oltre l'uso che se ne fa normalmente. Segue la descrizione di alcuni esempi.
$ ls -l | more[Invio]
$ ls -l | less[Invio]
Scorre sullo schermo l'elenco del contenuto della directory corrente che probabilmente è troppo lungo per essere visualizzato senza l'aiuto di uno tra questi due programmi.
$ more README[Invio]
$ less README[Invio]
Scorre sullo schermo il contenuto del file README.
Il programma less è sensibile al contenuto della variabile di ambiente LESSCHARSET, che serve a specificare quale insieme di caratteri si utilizza per la visualizzazione. Tuttavia, di solito non è necessario impostare questa variabile, perché le informazioni necessarie a determinare quale insieme di caratteri utilizzare provengono da altre variabili di ambiente di uso più generalizzato.
|
Tabella 43.3. Alcune voci per la selezione dell'insieme di caratteri visualizzabile con less, attraverso la variabile di ambiente LESSCHARSET.
|
Secondo la filosofia dei sistemi Unix, tutti i programmi dovrebbero essere accompagnati da una pagina di manuale, ovvero man page. Si tratta di un documento stringato sull'uso di quel programma particolare, scritto in uno stile abbastanza uniforme.
Si distinguono diverse sezioni di queste pagine di manuale, a seconda del genere di informazioni in esse contenute. Può infatti accadere che esistano più pagine con lo stesso nome, appartenenti però a sezioni diverse. La tabella 43.4 riporta l'elenco di queste sezioni secondo la struttura usata comunemente nei sistemi Unix.
|
Tabella 43.4. Sezioni delle pagine di manuale nei sistemi Unix. |
Quando si vuole fare riferimento a una pagina di manuale, se ne indica il nome seguito da un numero tra parentesi, che ne esprime la sezione. Per cui, man(1) indica la pagina di manuale di nome man nella prima sezione. Spesso, nella documentazione, si fa riferimento ai programmi in questo modo, per dare istantaneamente l'informazione di dove raggiungere le notizie che riguardano quel programma particolare.
Questa documentazione viene consultata normalmente attraverso il programma man che a sua volta, solitamente, si avvale di less, oppure more, per scorrere il documento. La tabella 43.1 mostra l'elenco dei comandi comuni essenziali di questi due programmi.
Le pagine di manuale possono trovarsi in diverse posizioni all'interno del file system. Quelle elencate di seguito sono standard.
Queste directory sono tutte suddivise o suddivisibili nello stesso modo. Si intende indicare una qualsiasi di queste directory di partenza come mandir.
La collocazione effettiva dei file che costituiscono le pagine di manuale è nelle directory esprimibili nella forma seguente:
mandir[/locale]/mansezione[/architettura] |
Ciò significa che, oltre alle directory mandir/ già viste, esiste un'altra directory, locale/, eventuale, che poi si scompone in diverse sottodirectory in funzione delle sezioni delle pagine di manuale esistenti (di solito da man1/ a man9/), ognuna delle quali può articolarsi ulteriormente in funzione delle differenze tra un'architettura e l'altra.
La directory locale/ è facoltativa, nel senso che spesso manca. Può essere utilizzata per distinguere tra le pagine di manuale di lingue diverse o di formati diversi. Il nome di questa directory è stabilito dallo standard POSIX 1003.1 secondo la sintassi seguente:
linguaggio[_territorio][.insieme_di_caratteri][,versione] |
linguaggio è una sigla di due caratteri minuscoli definiti dallo standard ISO 639 (sezione 104);
territorio è una sigla facoltativa di due caratteri maiuscoli definiti dallo standard ISO 3166 (sezione 105);
insieme_di_caratteri è una sigla numerica che esprime l'insieme di caratteri utilizzato, secondo lo standard ISO (in pratica è il numero dello standard ISO).
versione è un'indicazione supplementare non ben definita, della quale si cerca di scoraggiare l'utilizzo.
Nel caso delle pagine di manuale in italiano, queste, ammesso che siano disponibili, dovrebbero trovarsi nelle directory mandir/it_IT/mansezione, oppure in mandir/it/mansezione (senza specificare il territorio). Di solito non si usa l'indicazione dell'insieme di caratteri perché si sottintende essere quello configurato in generale per l'uso del terminale (la variabile LANG e le variabili LC_*). Per fare in modo però che queste directory vengano utilizzate effettivamente, è necessario che la variabile di ambiente LANG contenga il valore it_IT.
Anche la directory che definisce l'architettura è facoltativa ed è necessaria solo quando in una sezione determinata esistono pagine di manuale riferite a programmi o altre informazioni dipendenti da particolari caratteristiche architetturali.
Il comportamento di man può essere configurato attraverso un file di configurazione, che a seconda dei casi, nei sistemi GNU potrebbe essere il file /etc/man.config o /etc/manpath.config. Tra le tante cose, questo file contiene gli argomenti da fornire ai programmi utilizzati per la formattazione del testo da visualizzare o da stampare. Si osservino gli estratti seguenti, riferiti rispettivamente a /etc/man.config e a /etc/manpath.config:
|
|
Una cosa che potrebbe essere necessario modificare nel file /etc/man.config è l'opzione -T di groff e di geqn. Utilizzandola nel modo che si vede nell'esempio (-Tutf8), serve a consentire la visualizzazione dei caratteri accentati delle pagine di manuale tradotte in italiano, quando si dispone di una configurazione locale per l'insieme di caratteri ISO 10646, con una codifica UTF-8.
Come già accennato, per visualizzare il contenuto di una pagina di manuale si utilizza il programma man, ma sono disponibili anche i comandi whatis e apropos per cercare informazioni al loro interno. (1)
man [opzioni] nome... |
L'eseguibile man formatta ed emette attraverso lo standard output la pagina di manuale indicata dal nome. Lo scorrimento del testo che compone le pagine di manuale indicate negli argomenti viene fatto attraverso un programma esterno, richiamato automaticamente da man. Solitamente si tratta di more o di less. Di conseguenza, i comandi per lo scorrimento del testo dipendono dal tipo di programma utilizzato. Se si tratta di uno di questi due appena citati, sono sempre validi almeno quelli riportati nella tabella 43.1.
|
Tabella 43.8. Alcune opzioni.
|
Segue la descrizione di alcuni esempi.
$ man ls[Invio]
$ man 8 lilo[Invio]
Visualizza la pagina di manuale nell'ottava sezione, del programma lilo.
whatis parola... |
Il programma whatis cerca la descrizione di una o più pagine di manuale corrispondenti ai nomi indicati come argomento.
|
Originariamente, la ricerca relativa a whatis e apropos avveniva in elenchi costruiti appositamente per mezzo del comando makewhatis. |
Il risultato della ricerca viene emesso attraverso lo standard output. Sono visualizzate solo le corrispondenze con parole intere.
L'esempio seguente visualizza le descrizioni aventi la parola ls nel nome della pagina:
$ whatis ls[Invio]
apropos stringa... |
Il programma apropos cerca la descrizione di una o più pagine di manuale corrispondenti, che contengono al loro interno la stringa indicata (la ricerca viene fatta solo nella descrizione, nome compreso, e non nel corpo della pagina di manuale)
Il risultato della ricerca viene emesso attraverso lo standard output.
L'esempio seguente visualizza le descrizioni contenenti la stringa keyboard:
$ apropos keyboard[Invio]
La documentazione Info è un ipertesto realizzato dai file Info e leggibile attraverso il programma info oppure all'interno di Emacs. I file di questo ipertesto si trovano normalmente nella directory /usr/share/info/.
La documentazione Info è organizzata in file contenenti dei nodi. Ogni nodo ha un nome e rappresenta un'unità di informazioni. Trattandosi di un sistema ipertestuale, ogni nodo può avere riferimenti ad altri nodi contenenti informazioni aggiuntive o collegate. Quasi tutti i nodi contengono almeno dei riferimenti standard definiti dalle voci seguenti:
previous -- precedente;
next -- successivo;
up -- superiore.
Gli altri riferimenti possono essere organizzati in forma di menù o di riferimenti incrociati (cross-reference). Ogni file Info contiene almeno un nodo principale: Top. I nodi vengono identificati formalmente secondo la notazione seguente:
[(file_info)][nome_del_nodo] |
Se si indica solo il nome del nodo, si fa implicitamente riferimento al file utilizzato in quel momento determinato; se si indica solo il nome del file, si fa implicitamente riferimento al nodo Top.
L'eseguibile info consente di consultare i file Info senza l'ausilio di Emacs:
info [opzioni] [voce...] |
Se non viene indicato alcun argomento, in particolare, se non viene indicato il file Info da consultare, viene aperto il file /usr/share/info/dir.
|
Tabella 43.9. Alcune opzioni. |
Segue la descrizione di alcuni esempi.
$ info -f pippo.info[Invio]
Inizia la visualizzazione del file pippo.info a partire dal suo nodo principale.
$ info -f pippo.info pappa[Invio]
Seleziona la voce di menù pappa che dovrebbe essere contenuta nel nodo principale del file pippo.info.
$ info -f info[Invio]
Inizia la visualizzazione del file info a partire dal suo nodo principale.
$ info info[Invio]
Seleziona la voce di menù info dal nodo principale del file dir (/usr/share/info/dir) che è quello predefinito.
Per poter leggere le informazioni contenute in questi file attraverso l'eseguibile info, occorre conoscere alcuni comandi che non sono necessariamente intuitivi. Questi comandi si impartiscono semplicemente premendo il tasto della lettera o del simbolo corrispondente. Alcuni di questi comandi richiedono degli argomenti, in tal caso si è costretti a inserirli e a farli seguire da [Invio]. I comandi più importanti sono riportati nella tabella 43.10.
|
Tabella 43.10. Elenco dei comandi principali di info.
|
Quando si usa un ipertesto è molto importante conoscere il modo con cui si può ritornare sui propri passi. In questo caso, il comando [l] permette di tornare indietro ed è particolarmente utile dopo la selezione di un comando di aiuto come [h] o [?].
La figura 43.11 mostra il nodo principale del file info, cioè del documento che spiega il funzionamento di questo tipo di ipertesto.
|
Figura 43.11. La guida all'uso della documentazione Info.
|
La prima riga, quella che appare in alto, contiene in particolare il nome del file e del nodo.
|
La penultima riga, la seconda dal basso, riporta ancora il nome del file e del nodo, oltre alla dimensione del nodo in righe e alla parola All. Si osservi che in questo caso il file è effettivamente info.info.gz, che presumibilmente è stato compresso con Gzip.
|
La parola All indica in questo caso che il nodo appare completamente nello spazio a disposizione sullo schermo o nella finestra. L'ultima riga dello schermo viene usata per dare informazioni all'utilizzatore e come spazio per l'inserimento di argomenti quando i comandi ne richiedono.
Sulla parte iniziale di ogni nodo, insieme al nome del file e del nodo stesso, sono riportati alcuni riferimenti standard (ad altri nodi). Sono rappresentati simbolicamente dai termini Next (successivo), Prev (precedente) e Up (superiore). Chi ha redatto il file Info ha definito quali devono essere effettivamente i nodi a cui queste voci si riferiscono e a tali nodi si accede utilizzando i comandi [n], [p] e [u], rispettivamente.
|
Tabella 43.14. Elenco dei comandi per la navigazione attraverso i riferimenti standard.
|
Il riferimento Up non corrisponde necessariamente al nodo principale (Top) del file che si sta consultando, ma a quello che in quel momento, per qualche motivo, rappresenta un riferimento principale. Lo stesso tipo di ragionamento vale per i riferimenti Next e Prev che rispecchiano solo una sequenza di massima.
Il testo di un nodo può essere più lungo delle righe a disposizione sullo schermo o nella finestra. Per scorrere il testo si utilizza la barra spaziatrice per avanzare e il tasto [Canc] per indietreggiare. È però necessario fare attenzione: se si eccede si prosegue su altri nodi, attraverso un percorso predefinito che solitamente non coincide con i riferimenti Next e Prev già visti.
|
Tabella 43.15. Elenco dei comandi per lo scorrimento naturale del documento.
|
L'utilità di un ipertesto sta nella possibilità di raggiungere le informazioni desiderate seguendo un percorso non sequenziale. I documenti Info utilizzano due tipi di riferimenti (oltre a quelli standard): i menù e i riferimenti incrociati. I primi si distinguono perché sono evidenziati dalla sigla * Menu: seguita da un elenco di riferimenti; sono cioè staccati dal testo normale. I riferimenti incrociati appaiono invece all'interno del testo normale e sono evidenziati dalla sigla * Note Cross:.
Le voci di menù possono essere selezionate attraverso il comando [m] seguito dal nome del nodo; le voci dei riferimenti incrociati possono essere selezionate attraverso il comando [f] seguito dal nome del nodo.
L'utilità di avere due comandi diversi sta nel fatto che questi nomi possono essere indicati in forma abbreviata (per troncamento), indicando solo quello che serve per distinguerli dagli altri. Distinguendo i riferimenti raggruppati in menù, rispetto a quelli che appaiono nel testo, si riducono le possibilità di equivoci.
|
Tabella 43.16. Elenco dei comandi per la selezione dei riferimenti.
|
Per facilitare la selezione dei riferimenti che appaiono nel testo di un nodo (menù inclusi), si può utilizzare il tasto [Tab] per posizionare il cursore all'inizio della prossima voce e il tasto [Invio] per selezionare il nodo a cui fa riferimento la voce su cui si trova il cursore.
Se si conosce esattamente il nome di un nodo che si vuole raggiungere, si può utilizzare il comando [g] seguito dal nome del nodo stesso.
Quando si naviga all'interno della documentazione Info è sempre bene tenere a mente il comando [l] che permette di ritornare al nodo attraversato precedentemente.
|
Tabella 43.17. Altri comandi utili. |
I pacchetti di programmi più importanti sono accompagnati da documentazione disponibile in vari formati (testo, LaTeX, TeX, SGML, HTML, PostScript, PDF ecc.). Questa si trova collocata normalmente in sottodirectory discendenti da /usr/share/doc/.
I documenti HOWTO non accompagnano i pacchetti di programmi come loro parte integrante, essendo delle guide aggiuntive con scopi che vanno oltre la semplice documentazione del funzionamento di un solo pacchetto particolare. La maggior parte delle distribuzioni GNU include anche i file di documentazione HOWTO. Solitamente, questi vengono installati al di sotto della directory /usr/share/doc/HOWTO/.
Un'altra fonte di documentazione sui sistemi GNU (e non solo) sono le cosiddette FAQ o Frequently asked questions. Si tratta di informazioni disordinate in forma di botta e risposta. Solitamente si trovano al di sotto della directory /usr/share/doc/FAQ/.(2)
A fianco della documentazione standard fornita più o meno con tutte le distribuzioni GNU/Linux, ci sono dei libri veri e propri disponibili liberamente. Questi sono raccolti all'interno del progetto LDP, o Linux documentation project.
Questi documenti, normalmente disponibili sia in PostScript/PDF, sia in HTML, sono raggiungibili a partire da <http://www.ibiblio.org/pub/Linux/docs/LDP/> e dai siti speculari relativi.
Oltre alla documentazione citata nelle sezioni precedenti, esistono altri documenti che possono essere ritrovati a partire da <http://www.ibiblio.org/pub/Linux/docs/> e dai siti speculari relativi.
Meritano particolare attenzione i riferimenti seguenti:
Gary's Encyclopedia
Connected: An Internet Encyclopedia
Internet FAQ Archives
Appunti di informatica libera 2007.02 --- Copyright © 2000-2007 Daniele Giacomini -- <daniele (ad) swlibero·org>
2) In italiano qualcuno usa la definizione «filza di assilli quotidiani».
Dovrebbe essere possibile fare riferimento a questa pagina anche con il nome documentazione.htm
[successivo] [precedente] [inizio] [fine] [indice generale] [indice ridotto] [indice analitico]
