Je pense que le problème c'est plutôt que la vaste majorité des pages de man considèrent que c'est le manuel de référence d'une commande
Bah oui mais ça ne me choque pas, c'est même logique : man = manuel :-)
Par contre, on est bien d'accord qu'un manuel n'est pas un tutorial, mais se veut exhaustif.
Reste qu'il existe bien souvent une section EXAMPLES qui remplit ce rôle. Il n'y a qu'à voir le man de Mplayer qui bien qu'indigeste est extrêmement complet, et l'on y retrouve une liste d'exemples d'utilisation assez complète (« Convertit les sous-titres au format MPsub », « Joue un fichier AAC 6 canaux avec seulement deux enceintes », « Ne lire que les chapitres 5, 6, 7 d'un DVD », etc).
Ou plus récemment, ayant eu à jouer avec l'iSCSI, les pages de tgtadm et iscsiadm ne sont pas très lisibles, leurs exemples m'ont permis de démarrer.
Après, il existe aussi la commande info : plus interactive que man, elle se prête également mieux à ce rôle d'introduction.
Et puis, quand on découvre une commande et qu'on est choqué par la vacuité de la page de man, on n'est pas non plus en mesure de contribuer à la documentation. Si j'arrive pas à utiliser, je désinstalle et passe à un autre logiciel de la même catégorie.
Tu peux toujours te mettre en contact avec l'auteur pour avoir des explications plus directes (surtout qu'il est en principe nommé dans la page de man) et la compléter par la suite.
Mieux vaut dans ce cas participer en équipe que tout seul dans son coin puis envoyer le résultat.
Article Quarante-Deux : Toute personne dépassant un kilomètre de haut doit quitter le Tribunal. -- Le Roi de Cœur
[^] # Re: ASCII video...
Posté par zebra3 . En réponse à la dépêche Sortie de la version 20101222 de GNU Parallel. Évalué à 2.
Bah oui mais ça ne me choque pas, c'est même logique : man = manuel :-)
Par contre, on est bien d'accord qu'un manuel n'est pas un tutorial, mais se veut exhaustif.
Reste qu'il existe bien souvent une section EXAMPLES qui remplit ce rôle. Il n'y a qu'à voir le man de Mplayer qui bien qu'indigeste est extrêmement complet, et l'on y retrouve une liste d'exemples d'utilisation assez complète (« Convertit les sous-titres au format MPsub », « Joue un fichier AAC 6 canaux avec seulement deux enceintes », « Ne lire que les chapitres 5, 6, 7 d'un DVD », etc).
Ou plus récemment, ayant eu à jouer avec l'iSCSI, les pages de tgtadm et iscsiadm ne sont pas très lisibles, leurs exemples m'ont permis de démarrer.
Après, il existe aussi la commande info : plus interactive que man, elle se prête également mieux à ce rôle d'introduction.
Et puis, quand on découvre une commande et qu'on est choqué par la vacuité de la page de man, on n'est pas non plus en mesure de contribuer à la documentation. Si j'arrive pas à utiliser, je désinstalle et passe à un autre logiciel de la même catégorie.
Tu peux toujours te mettre en contact avec l'auteur pour avoir des explications plus directes (surtout qu'il est en principe nommé dans la page de man) et la compléter par la suite.
Mieux vaut dans ce cas participer en équipe que tout seul dans son coin puis envoyer le résultat.
Article Quarante-Deux : Toute personne dépassant un kilomètre de haut doit quitter le Tribunal. -- Le Roi de Cœur