3 581
contributi
Documentazione Debian: differenze tra le versioni
verificata per Buster, controllo link/esistenza dei pacchetti di documentazione
S3v (discussione | contributi) (corretti link) |
(verificata per Buster, controllo link/esistenza dei pacchetti di documentazione) |
||
| Riga 6: | Riga 6: | ||
Tutta la documentazione è completamente libera e modificabile, chiunque può suggerire cambiamenti. | Tutta la documentazione è completamente libera e modificabile, chiunque può suggerire cambiamenti. | ||
{{Versioni compatibili}} | {{Versioni compatibili|Jessie|Stretch|Buster}} | ||
== Introduzione == | == Introduzione == | ||
Questa guida cercherà di raggruppare il maggior numero possibile di link e informazioni riguardanti la documentazione ufficiale presente in Debian. Se qualcosa manca, basta aggiungerla!<br/> | Questa guida cercherà di raggruppare il maggior numero possibile di link e informazioni riguardanti la documentazione ufficiale presente in Debian. Se qualcosa manca, basta aggiungerla!<br/> | ||
| Riga 28: | Riga 28: | ||
[https://www.debian.org/releases/stable/installmanual Guida all'installazione di Debian]<br/> | [https://www.debian.org/releases/stable/installmanual Guida all'installazione di Debian]<br/> | ||
Questa guida è disponibile come [[pacchetto]] per diverse architetture. Ad esempio per leggere la guida sull'installazione per ''amd64'', è sufficiente installare con [[privilegi di amministrazione]] il pacchetto '''installation-guide-amd64''': | Questa guida è disponibile come [[pacchetto]] per diverse architetture. Ad esempio per leggere la guida sull'installazione per ''amd64'', è sufficiente installare con [[privilegi di amministrazione]] il pacchetto '''installation-guide-amd64''': | ||
<pre># apt | <pre># apt install installation-guide-amd64</pre> | ||
altri pacchetti disponibili: '''installation-guide-arm64''', '''installation-guide-armel''', '''installation-guide-armhf''', '''installation-guide-i386''', '''installation-guide-kfreebsd-amd64''', '''installation-guide-kfreebsd-i386''', '''installation-guide-mips''', '''installation-guide-mipsel''', '''installation-guide-powerpc''', '''installation-guide-ppc64el''', '''installation-guide-s390x'''. | altri pacchetti disponibili: '''installation-guide-arm64''', '''installation-guide-armel''', '''installation-guide-armhf''', '''installation-guide-i386''', '''installation-guide-kfreebsd-amd64''', '''installation-guide-kfreebsd-i386''', '''installation-guide-mips''', '''installation-guide-mipsel''', '''installation-guide-powerpc''', '''installation-guide-ppc64el''', '''installation-guide-s390x'''. | ||
| Riga 87: | Riga 87: | ||
Ulteriore documentazione può essere contenuta in pacchetti separati che hanno, tipicamente ma non necessariamente, nel nome l'indicazione "-doc". È caso ad esempio di "linux-doc" o di "apt-doc"; ma ne esistono tantissimi altri.<br/> | Ulteriore documentazione può essere contenuta in pacchetti separati che hanno, tipicamente ma non necessariamente, nel nome l'indicazione "-doc". È caso ad esempio di "linux-doc" o di "apt-doc"; ma ne esistono tantissimi altri.<br/> | ||
La lista può essere ottenuta a partire dal [[tag]] "role:documentation" che accompagna pacchetti di questo tipo: | La lista può essere ottenuta a partire dal [[tag]] "role:documentation" che accompagna pacchetti di questo tipo: | ||
<pre>$ aptitude search " | <pre>$ aptitude search "?tag(documentation)"</pre> | ||
(forma abbreviata: <code>"~Gdocumentation"</code>)<br/> | |||
È possibile utilizzare anche il solo <code>debtags</code> come segue, senza ricorrere alla ricerca avanzata di <code>aptitude</code>: | È possibile utilizzare anche il solo <code>debtags</code> come segue, senza ricorrere alla ricerca avanzata di <code>aptitude</code>: | ||
<pre>$ debtags search role::documentation</pre> | <pre>$ debtags search role::documentation</pre> | ||
Notare che per effettuare una ricerca basata su tag servirà almeno uno dei pacchetti '''[[aptitude]]''' e '''<code>debtags</code>'''. Per installare quello preferito, con [[privilegi di amministrazione]] è sufficiente: | |||
<pre># apt install aptitude | |||
# apt install debtags</pre> | |||
== Le pagine di manuale == | == Le pagine di manuale == | ||
Anche note come man pages o [[manpage]] o pagine man, sono probabilmente il tipo di documentazione più conosciuto e immediatamente accessibile a chiunque si trovi a che fare con una distribuzione Debian.<br/> | Anche note come man pages o [[manpage]] o pagine man, sono probabilmente il tipo di documentazione più conosciuto e immediatamente accessibile a chiunque si trovi a che fare con una distribuzione Debian.<br/> | ||
La policy di Debian impone che qualunque pacchetto o funzione o libreria utilizzata debba essere accompagnata da una pagina di manuale, per cui è sufficiente un: | La policy di Debian impone che qualunque pacchetto o funzione o libreria utilizzata debba essere accompagnata da una pagina di manuale, per cui è sufficiente un: | ||
<pre>$ man apt | <pre>$ man apt</pre> | ||
per aprire, ad esempio, la pagina di manuale di "apt | per aprire, ad esempio, la pagina di manuale di "apt".<br/> | ||
Le pagine di manuale si trovano nella directory <code>/usr/share/man/</code> . | Le pagine di manuale si trovano nella directory <code>/usr/share/man/</code> . | ||
== I file info == | == I file info == | ||
Alcuni pacchetti possono prevedere una documentazione molto corposa oppure includere diversi comandi, ciascuno dei quali con una propria documentazione. In questo caso, accanto alla pagina di manuale, viene installato anche un file "info" che è possibile leggere con il comando "info". Ad esempio il comando: | Alcuni pacchetti, in particolare buona parte di quelli appartenenti al [[Il Progetto GNU|Progetto GNU]], possono prevedere una documentazione molto corposa oppure includere diversi comandi, ciascuno dei quali con una propria documentazione. In questo caso, accanto alla pagina di manuale, viene installato anche un file "info" che è possibile leggere con il comando "info". Ad esempio il comando: | ||
<pre>$ info grep</pre> | <pre>$ info grep</pre> | ||
permetterà di leggere il file "info" associato a grep.<br/> | permetterà di leggere il file "info" associato a grep.<br/> | ||
Fornisce informazioni molto utili in particolare per: <code>grub</code>, <code>find</code>, <code>nano</code>, <code>gnupg</code>, <code>wget</code>, <code>grep</code> e <code>sed</code>. Tutti i file info si trovano nella directory <code>/usr/share/info/</code> .<br/> | |||
In nuove installazioni di Debian 10 ([[Buster]]) è necessario installare il pacchetto, dato che non è più presente di default: | |||
<pre># apt install info</pre> | |||
== Il kernel Linux == | == Il kernel Linux == | ||
| Riga 113: | Riga 117: | ||
==== Kernel Hacker's Guide ==== | ==== Kernel Hacker's Guide ==== | ||
Contiene, sotto forma di manpage, la documentazione sulle API del kernel Linux. Il nome di questi pacchetti è del tipo '''linux-manual-versione''', ad esempio '''linux-manual-3.2''', '''linux-manual-3.16''', '''linux-manual-4.9''' . | Contiene, sotto forma di manpage, la documentazione sulle API del kernel Linux. Il nome di questi pacchetti è del tipo '''linux-manual-versione''', ad esempio '''linux-manual-3.2''', '''linux-manual-3.16''', '''linux-manual-4.9''' . | ||
Il pacchetto non è più presente a partire da Debian 10 ([[buster]]). | |||
==== Debian Kernel Handbook ==== | ==== Debian Kernel Handbook ==== | ||
| Riga 158: | Riga 164: | ||
|Estesa_da = | |Estesa_da = | ||
|Verificata_da = | |Verificata_da = | ||
: [[Utente:HAL 9000|HAL 9000]] | :[[Utente:HAL 9000|HAL 9000]] 08:55, 28 lug 2019 (CEST) | ||
|Numero_revisori = 1 | |Numero_revisori = 1 | ||
}} | }} | ||
[[Categoria:Introduzione a Debian]][[Categoria:Documentazione tecnica]][[Categoria: Risorse]] | [[Categoria:Introduzione a Debian]][[Categoria:Documentazione tecnica]][[Categoria: Risorse]] | ||