> man = manuel
Oui mais tout manuel n'est pas forcément un manuel de référence. Par exemple, un manuel de vol en aéronautique décrit des exemples précis (le comportement à tenir dans chaque situation), alors qu'un manuel de référence de l'avion décrirait chaque bouton un par un.
> Après, il existe aussi la commande info : plus interactive que man, elle
> se prête également mieux à ce rôle d'introduction.
Un livre ou une page howto écrite de haut en bas sans liens hypertextuels fonctionnent très bien comme introduction, alors que le côté hypertextuel de la commande info me perd dans des méandres de détails dont on ne voit plus l'architecture globale. En outre l'interface textuelle de info demande une disposition d'esprit particulière (l'auteur d'info est le même que celui d'emacs).
Je cite l'auteur d'info2man* : « Many GNU manual pages are insultingly empty. Many GNU people seem to be arrogant scum in that they produce farces of manual entries, each prefaced with ``we like info, so we don't maintain this page, and it's probably a pack of lies - go read the info file''. »
[^] # Re: ASCII video...
Posté par JGO . En réponse à la dépêche Sortie de la version 20101222 de GNU Parallel. Évalué à 2.
Oui mais tout manuel n'est pas forcément un manuel de référence. Par exemple, un manuel de vol en aéronautique décrit des exemples précis (le comportement à tenir dans chaque situation), alors qu'un manuel de référence de l'avion décrirait chaque bouton un par un.
> Après, il existe aussi la commande info : plus interactive que man, elle
> se prête également mieux à ce rôle d'introduction.
Un livre ou une page howto écrite de haut en bas sans liens hypertextuels fonctionnent très bien comme introduction, alors que le côté hypertextuel de la commande info me perd dans des méandres de détails dont on ne voit plus l'architecture globale. En outre l'interface textuelle de info demande une disposition d'esprit particulière (l'auteur d'info est le même que celui d'emacs).
Je cite l'auteur d'info2man* : « Many GNU manual pages are insultingly empty. Many GNU people seem to be arrogant scum in that they produce farces of manual entries, each prefaced with ``we like info, so we don't maintain this page, and it's probably a pack of lies - go read the info file''. »
* http://www.cskk.ezoshosting.com/cs/css/info2pod.html