108 votes

Quelle est la différence entre la documentation "man" et "info" ?

En ce qui concerne les pages de manuel et la documentation d'aide info :

Pourquoi existe-t-il deux sources de documentation aussi similaires ?
Parfois, une page de manuel est disponible et l'information ne l'est pas ; ou vice-versa.
Je n'ai pas encore compris la logique et la raison derrière tout ça.

Peut-être y a-t-il une différence significative entre eux, mais même si c'est le cas, pourquoi existent-ils tous les deux ? Cela ressemble à un dédoublement inutile.

98voto

Neall Points 251

Les pages de manuel sont le moyen traditionnel sous UNIX de distribuer de la documentation sur les programmes. Le terme "man page" lui-même est l'abréviation de "manual page", car elles correspondent aux pages du manuel imprimé ; les "sections" des pages de manuel (1 pour les commandes, 2 pour les appels système, etc.) correspondent aux sections du manuel UNIX complet. Le support est toujours là si vous voulez imprimer une page de manuel sur papier, bien que cela soit rarement fait de nos jours, et le nombre de pages de manuel rend impossible de les relier toutes en un seul livre.

Au début des années 90, le Projet GNU a décidé que le système de documentation "homme" était dépassé, et a écrit le système de documentation "homme". info pour le remplacer : info dispose de fonctionnalités d'hyperliens de base et d'un langage de balisage plus simple à utiliser (comparé au système "troff" utilisé pour les pages de manuel). En outre, GNU préconise de ne pas utiliser les pages de manuel du tout et soutient que les systèmes logiciels complexes doivent disposer d'une documentation complète et détaillée plutôt que d'un ensemble de courtes pages de manuel.

Il existe en fait d'autres systèmes de documentation en usage, en plus des systèmes suivants homme y info : GNOME et KDE ont leur propre système, basé sur HTML, etc.

En fin de compte, la forme sous laquelle vous obtenez la documentation dépend des politiques internes du projet qui a fourni le logiciel en premier lieu - il n'y a pas de norme mondialement acceptée.

31voto

Eric Points 266

Info est le format par défaut pour la documentation au sein du projet GNU, man est le format traditionnel beaucoup plus ancien pour UNIX.

Info utilise Texinfo comme format source, qui est un ensemble de macros pour TeX, ce qui facilite grandement la création de versions imprimées ou de PDF de "bonne facture".

En général, les pages de manuel traitent d'un sujet spécifique (une commande, un fichier de configuration, une fonction système, ...), tandis que les informations ont normalement la structure d'un manuel combiné, comme un livre.

18voto

Man utilise less pour afficher la page de manuel qui, à son tour, utilise les raccourcis clavier de vim, tandis que info utilise les raccourcis clavier d'emacs et les commandes standard d'emacs pour rechercher, quitter, etc.

SistemesEz.com

SystemesEZ est une communauté de sysadmins où vous pouvez résoudre vos problèmes et vos doutes. Vous pouvez consulter les questions des autres sysadmins, poser vos propres questions ou résoudre celles des autres.

Powered by:

X