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

92

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 et l’information n’est pas; ou vice versa.
Je n'ai pas encore compris la rime et la raison derrière cela.

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.

Peter.O
la source
1
GNU-Info Bad, Man (1) Bon à partir de 2003, une lecture amusante. Flat is better than nested.
n611x007
Essayez de faire info infoet man info. man infomontre des exemples colorés. Je suis une personne plus visuelle, la même couleur me rend somnolent. La syntaxe man avec un peu de couleur le rend compréhensible rapidement.
randominstanceOfLivingThing

Réponses:

80

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 papier, bien que cela soit rarement fait de nos jours, et le nombre impressionnant 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 GNU a décidé que le système de documentation "man" était obsolète et a écrit la commande info pour le remplacer: info a des fonctions de base permettant l’hyperlien et un langage de balisage plus simple à utiliser (par rapport au système "troff" utilisé pour pages de manuel). En outre, GNU recommande de ne pas utiliser de pages de manuel et affirme que les systèmes logiciels complexes doivent disposer d’une documentation complète et complète, et non d’un ensemble de pages de manuel courtes.

Il y a en fait d'autres systèmes de documentation en cours d'utilisation, en plus de 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.

Riccardo Murri
la source
14
infon'a jamais vraiment décollé, n'est-ce pas?
UncleZeiv
9
@UncleZeiv: exécuter infosans paramètres pour avoir une idée du nombre d'applications utilisant la documentation au format info.
Janv
24

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

Info utilise Texinfo comme format source, un ensemble de macros pour TeX, ce qui facilite beaucoup la création de versions imprimées ou de fichiers PDF "attrayants".

En règle générale, 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é, plus d'un livre.

JanC
la source
14

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.


la source
3
La question des liaisons de touches est intéressante (donc j'ai googlé) ... Il semble qu'il infoexiste une option de liaison de clés dans le VI: --vi-keys (Utilisez des raccourcis clavier similaires à vi et similaires ) ... $ alias info = 'info - vi-keys '... peut-être?
Peter.O