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


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

Pourquoi deux sources de documentation similaires existent-elles?
Parfois, une page de manuel est disponible et les informations ne sont pas disponibles. ou vice versa.
Je n'ai pas encore saisi la raison et la rime.

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.


80
2017-10-25 08:56


origine


GNU-Info Bad, Man (1) Bon à partir de 2003 lecture ludique. Flat is better than nested. - n611x007
Essayez de faire info info et man info. man info montre des exemples colorés. Je suis une personne plus visuelle, utiliser la même couleur sur toute la surface me rend endormi. La syntaxe de l'homme avec un peu de couleur le rend rapidement compréhensible. - randominstanceOfLivingThing


Réponses:


Les pages de manuel sont la manière traditionnelle d'UNIX de distribuer 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 pages de manuel "sections" (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 souhaitez imprimer une page de manuel sur du papier, même si cela se fait rarement de nos jours, et que le nombre de pages de manuel rend tout impossible de tout lier 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 obsolète et a écrit le Info commande pour le remplacer: Info possède des fonctionnalités de base de liens hypertextes et un langage de balisage plus simple à utiliser (par rapport au système "troff" utilisé pour les pages de manuel). De plus, GNU plaide contre l'utilisation de pages de manuel du tout et soutient que les systèmes logiciels complexes devraient avoir une documentation complète et complète plutôt qu'un simple ensemble de pages de manuel.

Il existe en fait d'autres systèmes de documentation en cours d'utilisation, en plus homme et Info: GNOME et KDE ont leur propre système 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’existe pas de norme acceptée à l’échelle mondiale.


69
2017-10-25 09:26



info n'a jamais vraiment décollé, n'est-ce pas? - UncleZeiv
@UncleZeiv: courir info sans paramètres pour avoir une idée du nombre d'applications utilisant la documentation au format info. - JanC
Impressionnant. Une question: qui étaient les principaux propriétaires de ces systèmes Unix "traditionnels"? FreeBSD? - Aditya M P
xkcd.com/927 - cprn


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

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

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


18
2017-10-25 09:33



pour mentionner et expliquer texinfo - n611x007


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


10
2017-10-25 09:21



Le problème des keybindings est intéressant (alors j'ai googlé) ... Il semble que info a une option de raccourcis VI: --vi-keys (Use vi-like et moins semblable raccourcis clavier) ... $ alias info = 'info --vi-keys' ... peut-être? - Peter.O
pour mention vim vs emacs - n611x007