Préface

Les règles suivantes ont été suivies lors de la compilation de ce document.

	Avertissement
	On attend de vous que vous fassiez des efforts pour rechercher des réponses par vous-même au-delà de cette documentation. Ce document ne donne que des points de départs efficaces.

Vous devez chercher vous-même une solution dans les sources primaires.

Ce document fournit des informations en utilisant le style de présentation simplifié suivant, avec des exemples de commandes de l’interpréteur bash(1).

# command-in-root-account
$ command-in-user-account

Ces invites de l’interpréteur de commandes permettent de distinguer le compte utilisé et correspondent à la définition des variables d’environnement « PS1='\$' » et « PS2=' ' ». Ces valeurs ont été choisies pour ce document dans un but de lisibilité, elles ne sont pas représentatives d’un système réel.

All command examples are run under the English locale "LANG=en_US.UTF8". Please don't expect the placeholder strings such as command-in-root-account and command-in-user-account to be translated in command examples. This is an intentional choice to keep all translated examples to be up-to-date.

	Note
	Consultez la signification des variables d’environnement « $PS1 » et « $PS2 » dans bash(1).

L’action demandée à l’administrateur du système est écrite sous forme d’une phrase impérative, par exemple « Pressez la touche Entrée après la saisie de chaque chaîne de commande dans l’interpréteur de commandes. »

La colonne de description ou similaire dans le tableau peut contenir une locution nominale selon la convention de description courte du paquet qui supprime les articles se trouvant en tête tels que  « un » et « le » (« a », « the »). Elle peut contenir une phrase à l’infinitif comme locution nominale sans le « to » de tête (NdT : en français, une phrase impérative commençant par un verbe à l’infinitif), suivie de la description courte de la commande selon la convention des pages de manuel. Cela peut sembler bizarre à certaines personnes mais ce sont les choix voulus par l’auteur afin de garder cette documentation la plus simple possible. Ces locutions nominales, selon cette convention de description courte, n’ont pas de majuscule à la première lettre et ne se terminent pas par un point.

Un morceau de commande cité dans le paragraphe d’un texte sera signalé par une police « typewriter » (machine à écrire) entre guillemets, comme par exemple « aptitude safe-upgrade ».

Les données textuelles d’un fichier de configuration citées dans un paragraphe seront signalées par une police de type machine à écrire entre guillemets, comme par exemple « deb-src ».

Une commande sera indiquée par son nom dans la police machine à écrire suivi, de manière facultative, par le numéro de section de la page de manuel entre parenthèses, comme par exemple bash(1). Vous êtes encouragé à rechercher des informations complémentaires en entrant :

$ man 1 bash

Une page de manuel est indiquée par son nom dans la police machine à écrire suivie, entre parenthèses, du numéro de la section de la page de manuel, comme par exemple, sources.list (5). Vous êtes encouragé à rechercher des informations complémentaires en entrant :

$ man 5 sources.list

Une page info est indiquée par un fragment entre guillemets de la commande correspondante dans la police machine à écrire, comme par exemple, « info make ». Vous êtes encouragé à rechercher des informations complémentaires en entrant :

$ info make

Un nom de fichier est indiqué par une police machine à écrire entre guillemets, comme par exemple, « /etc/passwd ». En ce qui concerne les fichiers de configuration, vous êtes encouragé à rechercher des informations complémentaires en entrant :

$ sensible-pager "/etc/passwd"

Un nom de répertoire est indiqué par la police machine à écrire entre guillemets, comme par exemple, « /etc/apt/ ». Vous êtes encouragé à explorer son contenu en tapant ce qui suit.

$ mc "/etc/apt/"

Un nom de paquet est indiqué par son nom dans la police machine à écrire, comme par exemple vim. Vous êtes encouragé à rechercher des informations complémentaires en entrant :

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

On peut indiquer l’emplacement d’une documentation par son nom de fichier dans la police machine à écrire entre guillemets, comme par exemple « /usr/share/doc/sysv-rc/README.runlevels.gz » et « /usr/share/doc/base-passwd/users-and-groups.html » ou par son URL, comme par exemple https://www.debian.org. Vous êtes encouragé à lire la documentation en entrant.

$ zcat "/usr/share/doc/base-passwd/users-and-groups.txt.gz" | sensible-pager
$ sensible-browser "/usr/share/doc/base-passwd/users-and-groups.html"
$ sensible-browser "https://www.debian.org"

Une variable d’environnement est indiquée par son nom précédé d’un « $ » dans la police machine à écrire entre guillemets, comme par exemple « $TERM ». Vous êtes encouragé à obtenir sa valeur actuelle en entrant :

$ echo "$TERM"

Les données du popcon sont présentées comme une manière objective de mesurer la popularité de chaque paquet. Elles sont téléchargées depuis 2023-02-02 04:56:26 UTC et contiennent un total de 208164 soumissions de rapports pour 192570 paquets binaires et 25 architectures.

Le numéro de « popcon », précédé par un « V: » pour « votes », est calculé par « 1000 * (soumissions popcon pour le paquet exécuté récemment sur le PC)/(nombre total des soumissions popcon) ».

Le numéro de « popcon », précédé par un « I: » pour « installations », est calculé par « 1000 * (soumissions popcon pour le paquet installé sur le PC)/(nombre total des soumissions popcon) ».

Les données correspondant à la taille du paquet sont aussi présentées comme une mesure objective de chacun des paquets. Elles sont basées sur « Installed-Size: » (« taille installée ») indiquée par la commande « apt-cache show » ou « aptitude show  » (actuellement sur l’architecture amd64 et pour la version unstable). La taille est indiquée en Kio (kibioctet = unité pour 1024 octets).

Si vous découvrez des problèmes dans ce document, veuillez signaler les bogues du paquet debian-reference en utilisant reportbug(1). Veuillez inclure des suggestions de correction en lançant « diff -u » sur la version en texte brut ou sur le source.