Come trovare la documentazione all'interno del mio sistema GNU / Linux

Molti di quelli nuovi al mondo GNU / Linux sono pieni di dubbi e incapaci di trovare una risposta rapida alle loro preoccupazioni, a volte non hanno nemmeno una connessione attraverso la quale accedere a un forum di supporto e alla fine si ritrovano con l'idea che Linux è molto difficile per loro.

La maggior parte di coloro che si trovano in questa situazione non sono consapevoli che il nostro sistema contiene una buona parte delle risposte alle nostre preoccupazioni iniziali. Esistono essenzialmente tre fonti di documentazione in un sistema GNU / Linux: pagine di manuale (pagine man), pagine di informazioni (pagine di informazioni) e manuali delle applicazioni contenute in / usr / share / doc.

In questo articolo descriveremo in dettaglio ciascuna di queste fonti.

---

Pagine man

Le pagine di manuale o "pagine di manuale" sono le forme classiche di documentazione di riferimento in Linux e Unix. Idealmente, è possibile cercare nelle pagine di manuale la guida per qualsiasi comando, file di configurazione o routine di libreria.

In pratica, Linux è un software libero e alcune pagine non sono state scritte o mostrano la loro età. Tuttavia, le pagine man sono il primo posto in cui cercare quando hai bisogno di aiuto. Per accedere alle pagine man, digita semplicemente uomo seguito dall'argomento da approfondire.

Verrà avviato un cercapersone, quindi premerai q quando finisco di leggere. Ad esempio, per trovare informazioni sul comando ls, Vorrei scrivere:

$ uomo ls

Conoscendo le parti delle pagine man può essere utile saltare velocemente alle informazioni di cui hai bisogno, troverai le seguenti sezioni nella pagina man (Box 1):

Tabella 1: pagine del manuale

NOME	Nome e descrizione del comando
SINOSSI	Come utilizzare il comando
DESCRIZIONE	Spiegazione approfondita di come funziona il comando
ESEMPI	Suggerimenti su come utilizzare il comando
GUARDA ANCHE	Argomenti correlati (di solito nelle pagine man)

Sezioni delle pagine man

I file che compongono le pagine man sono archiviati in / usr / share / man (o in / usr / man su alcuni vecchi sistemi). All'interno di quella directory, troverai che le pagine di manuale sono organizzate nelle seguenti sezioni (Riquadro 2).

Tabella 2: Sezioni delle pagine del manuale

man1	Programmi utente
man2	Chiamate di sistema
man3	Funzioni di libreria
man4	File speciali
man5	Formato del file
man6	Giochi
man7	Miscellanea

Pagine man multiple

Alcuni argomenti sono presenti in più di una sezione. Per dimostrarlo, useremo il comando cosa è, che mostra tutte le pagine man disponibili per questo argomento:

$ che cosa è printf

printf (1) - formatta e stampa i dati

printf (3) - conversione dell'output formattato

In questo caso, uomo printf sarebbe sulla pagina della sezione 1 (Programmi utente). Se dovessimo scrivere un programma in C, saremmo più interessati alla pagina nella sezione 3 (Funzioni di libreria). È possibile richiamare una certa sezione delle pagine man specificandola sulla riga di comando, in modo da chiedere printf, possiamo scrivere:

$ uomo 3 printf

Trovare la pagina man corretta

A volte è difficile trovare alcune pagine man su un determinato argomento. In tal caso, potresti usare uomo -k per trovare la sezione NOME delle pagine man. Sappi che questa è una ricerca di sottostringhe, quindi qualcosa di simile uomo -k ls ti darebbe molti risultati, ecco un esempio che utilizza una parola più specifica:

$ man -k whatis whatis (1) - stampa le descrizioni delle pagine di manuale

Tutto su a proposito

L'esempio precedente ci ha portato alcuni punti in più. Primo, il comando a proposito è esattamente equivalente a uomo -k, (In realtà, ti darò un segreto. Quando corri uomo -k effettivamente eseguito a proposito dietro le quinte).

---

La riga di codice MANPATH

Passiamo ora al secondo tipo di documentazione che troveremo nel nostro sistema GNU / Linux. Per impostazione predefinita, il programma man cerca le pagine man in / usr / share / man, / usr / local / man, / usr / X11R6 / man e possibilmente / opt / man. a volte puoi trovare quello che ti serve aggiungendo un percorso aggiuntivo al percorso di ricerca. Stando così le cose, basta modificare /etc/man.conf in un editor di testo e aggiungi una riga come la seguente:

MANPATH / opt / man

Da qui in poi, qualsiasi pagina di manuale nella directory / opt / man sarà trovato. Ricorda che devi correre di nuovo fare ciò che è per aggiungere queste nuove pagine man al database cosa è.

---

Informazioni GNU

Uno dei difetti delle pagine di manuale è che non supportano l'ipertesto, quindi non è possibile passare facilmente da una pagina all'altra. Gli amici di GNU riconoscono questo difetto, quindi hanno inventato un altro formato di documentazione: le pagine "info".

Molti dei programmi GNU vengono forniti con un'ampia documentazione nel formato della pagina delle informazioni. Puoi iniziare a leggere le pagine informative con il comando info:

In questo modo porteremo un indice di tutte le pagine informative disponibili nel sistema. Ci si può muovere con i tasti freccia, seguire i "link" (indicati con una stella) utilizzando il tasto Invio e uscire premendo q. I tasti sono basati su Emacs, quindi dovrebbe essere facile navigare se hai familiarità con quell'editor.

Per ulteriori informazioni con l'uso di info, leggi la loro pagina informativa. Dovresti essere in grado di spostarti utilizzando i tasti sopra menzionati:

$ informazioni informazioni

---

/ usr / share / doc

C'è un'ultima fonte che può aiutarti all'interno del sistema Linux. Molti programmi sono dotati di documentazione aggiuntiva in altri formati: testo, PDF, PostScript, HTML, solo per citarne alcuni.

Dare un'occhiata al / usr / share / doc (/ usr / doc su vecchi sistemi). Troverai un lungo elenco di directory, ognuna delle quali viene fornita con le applicazioni sul tuo sistema. La ricerca in questa documentazione può spesso rivelare qualcosa di interessante, come tutorial o documentazione tecnica aggiuntiva. Un rapido controllo rivela un sacco di materiale disponibile per la lettura:

$ cd / usr / share / doc

$ find. -tipo f | wc -l

---

In altri articoli faremo riferimento a fonti esterne di documentazione come The Linux Documentation Project (LDP), mailing list e newsgroup.

Fonte: articolo tratto da GUTL e scritto da Maikel Llamaret Heredia. Collegamenti: https://blog.desdelinux.net, http://www.raybenjamin.com, http://forum.codecall.net, http://www.linfo.org,  http://www.esdebian.org