web-dev-qa-db-fra.com

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 similaires?
Parfois, une page de manuel est disponible mais pas l’information; ou vice versa.
Je n'ai pas encore compris la rime et la raison derrière celle-ci.

Peut-être y a-t-il une différence significative entre eux, mais même s'il y en a, pourquoi les deux existent-ils? Il semble inutile de doubler.

92
Peter.O

Les pages de manuel constituent la méthode UNIX traditionnelle de distribution de la documentation sur les programmes. Le terme "page de manuel" lui-même est l'abréviation de "page de manuel", car ils 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. La prise en charge est toujours disponible si vous souhaitez imprimer une page de manuel sur du papier, même si cela est rarement fait de nos jours, et le nombre considérable de pages de manuel rend tout simplement impossible de toutes les lier dans un seul livre.

Au début des années 90, le projet GN décida que le système de documentation "man" était obsolète et écrivit la commande info pour le remplacer: info a des fonctionnalités de base pour l’hyperlien et 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 de pages de manuel et affirme que les systèmes logiciels complexes devraient disposer d'une documentation complète et complète plutôt que d'un simple ensemble de pages de manuel courtes.

Il y a en fait d'autres systèmes de documentation utilisés, outre man et info : GNOME et KDE ont leur propre système basé sur HTML, etc.

En fin de compte, la forme dans 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 acceptée globalement.

79
Riccardo Murri

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

Info utilise Texinfo comme format source, un ensemble de macros pour TeX, ce qui permet de créer beaucoup plus facilement des versions imprimées ou des PDF "beaux".

Généralement, les pages de manuel concernent davantage 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é, plutôt que d'un livre.

22
JanC

man utilise moins pour afficher la page de manuel, qui utilise à son tour les liaisons de clé vim, tandis que info utilise les liaisons de clé emacs et les commandes standard emacs pour la recherche, la fermeture, etc.

14
user4687