Prefazione

Nella stesura di questo documento sono state seguite le seguenti linee guida.

	Avvertimento
	Il lettore deve fare lo sforzo di cercare risposte da solo andando oltre questa documentazione. Questo documento fornisce solo degli efficaci punti di partenza.

Il lettore deve cercare le soluzioni da solo dalle fonti primarie.

Questo documento fornisce informazioni attraverso il seguente stile semplificato di rappresentazione con esempi di comandi per la shell bash(1).

# <comando nell'account root>
$ <comando nell'account utente>

Questi prompt di shell distinguono gli account usati e corrispondono a ciò che si ottiene impostando le variabili d'ambiente in questo modo: "PS1='\$'" e "PS2=' '". Questi valori sono stati scelti per aumentare la leggibilità del documento e non sono quelli tipici di una reale installazione del sistema.

	Nota
	Si veda il significato delle variabili d'ambiente "$PS1" e "$PS2" in bash(1).

Le azioni che gli amministratori di sistema devono eseguire sono scritte all'infinito, ad esempio "Premere il tasto Invio dopo ogni stringa di comando digitata nella shell."

La colonna descrizione ed altre simili in tabelle possono contenere un sintagma nominale che segue le convenzioni per le descrizioni brevi dei pacchetti e che perde l'articolo iniziale quali "un" ed "il". Le colonne possono, in alternativa, contenere una verbo al presente seguendo la convenzione usata nella descrizione breve dei comandi nelle pagine man. Questa scelta potrà apparire strana per qualcuno, ma fa parte della scelta deliberata dell'autore di mantenere più semplice possibile lo stile di questa documentazione. In entrambi i casi l'iniziale non è maiuscola e manca il punto finale seguendo le dette convenzioni per le descrizioni brevi.

Un breve comando citato all'interno di un paragrafo di testo viene reso dal carattere a spaziatura fissa racchiuso tra virgolette doppie come in "aptitude safe-upgrade".

Dati testuali da un file di configurazione citati all'interno di un paragrafo di testo vengono resi ‪dal carattere a spaziatura fissa racchiuso tra virgolette doppie come in "deb-src".

Un comando viene reso dall'uso del carattere a spaziatura fissa per il suo nome, seguito eventualmente dal numero di sezione della sua pagina man tra parentesi, come in bash(1). Ci si senta incoraggiati ad ottenere ulteriori informazioni digitando quanto segue.

$ man 1 bash

Una pagina man viene resa dall'uso del carattere a spaziatura fissa per il suo nome seguito dal numero della sua sezione nelle pagine man racchiuso tra parentesi, come in sources.list(5). Ci si senta incoraggiati ad ottenere ulteriori informazioni digitando quanto segue.

$ man 5 sources.list

Una pagina info viene resa dal suo comando corrispondente in carattere a spaziatura fissa racchiuso tra virgolette doppie, come in "info make". Ci si senta incoraggiati ad ottenere ulteriori informazioni digitando quanto segue.

$ info make

Un nome di file viene reso dal carattere a spaziatura fissa tra virgolette doppie, come in "/etc/passwd". Per quanto riguarda i file di configurazione ci si senta incoraggiati ad ottenere ulteriori informazioni digitando quanto segue.

$ sensible-pager "/etc/passwd"

Un nome di directory viene reso dal carattere a spaziatura fissa tra virgolette doppie, come in "/etc/init.d". Ci si senta incoraggiati ad esplorare il suo contenuto digitando quanto segue.

$ mc "/etc/init.d/"

Un nome di pacchetto viene reso dal carattere a spaziatura fissa, come in vim. Ci si senta incoraggiati ad ottenere ulteriori informazioni digitando quanto segue.

$ dpkg -L vim
$ apt-cache show vim
$ aptitude show vim

La posizione di una documentazione può essere indicata con il nome di file in carattere a spaziatura fissa tra virgolette doppie, come in "/usr/share/doc/sysv-rc/README.runlevels.gz" e "/usr/share/doc/base-passwd/users-and-groups.html", oppure dal suo URL, come in http://www.debian.org. Ci si senta incoraggiati a leggere la documentazione digitando quanto segue.

$ zcat "/usr/share/doc/sysv-rc/README.runlevels.gz" | sensible-pager
$ sensible-browser "/usr/share/doc/base-passwd/users-and-groups.html"
$ sensible-browser "http://www.debian.org"

Una variabile d'ambiente viene resa dal suo nome preceduto dal segno "$" in carattere a spaziatura fissa tra virgolette doppie, come in "$TERM". Ci si senta incoraggiati ad ottenere il suo valore attuale digitando quanto segue.

$ echo "$TERM"

I dati da popcon sono usati come misura oggettiva della popolarità di ciascun pacchetto. Sono stati scaricati il 2017-05-07 12:05:21 UTC e contengono i dati totali inviati da 197536 rapporti su 161289 pacchetti binari e 26 architetture.

Il numero popcon, preceduto da "V:" che sta per "voti", è calcolato così: "1000 * (rapporti popcon inviati con il pacchetto eseguito di recente sul PC)/(numero totale di rapporti popcon inviati)".

Il numero popcon, preceduto da "I:" che sta per "installazioni", è calcolato così: "1000 * (rapporti popcon inviati con il pacchetto installato sul PC)/(numero totale di rapporti popcon inviati)".

Anche i dati sulla dimensione dei pacchetti sono usati come misura oggettiva per ciascun pacchetto. Sono basati sulla "Installed-Size:" riportata dal comando "apt-cache show" o "aptitude show" (attualmente sull'architettura amd64 per la versione unstable). La dimensione è riportata in KiB (Kibibyte = unità di 1024 byte).

Se si trovano errori in questo documento segnalare i bug nel pacchetto debian-reference usando reportbug(1). Se possibile, includere i suggerimenti di correzione come "diff -u alla versione in puro testo o ai sorgenti.