Du coup, pour en revenir au sujet, une section EXEMPLES (je traduis en français) fait rarement sens pour être systématisé... Je vais de préciser un peu mon propos.
Que faudrait-il mettre comme exemples dans man ls ou man cp ou man mv par exemple ? Comme elle dit à un moment, on apprend à travers un livre (ou aujourd'hui un site interactif, ou généralement accompagné de quelqu'un) pour surtout pratiquer. Et tous les cas qu'on va pratiquer se ramènent au synopsis de la commande ; que faut-il de plus ? (question sérieuse) Perso, le premier usage que j'ai du man c'est pour m'assurer/remémorer l'ordre des arguments.
Mon second usage est pour trouver la bascule qui va bien. Là, j'aime bien qu'il y ait la liste dans une section dédiée. Normalement la description de chacune devrait se suffire. Là aussi, je ne vois pas ce qu'une section d'exemples ferait en plus : les fois où j'en ai vu, ça me semblait toujours trivial et surtout il n'y a pas l'exemple qui correspond à ce que je recherchais, mais on ne peut illustrer toutes les combinaisons de bascules possibles... Non, le mieux reste encore qu'au niveau de chaque option il y ait le rappel des options conflictuelles les mentions de combinaisons problématiques. (par exemple -H vs -L dans le traitement des liens symboliques.)
Elle compare, à juste titre, avec un dictionnaire, et dit elle-même que ce n'est pas l'outil adéquat pour apprendre... On dirait qu'elle cherche une commande learn ou example que fournissent maintenant les programmes dit de cheatsheet
Il y a d'autres sections que j'aime bien consulter quand j'écris des scripts parce-qu'il faut comprendre quelles variables d'environnement vont influer et quels sont les bogues et/ou limitations connues. Ces mêmes sections sont utiles en dehors du scripting, quand l'on veut personnaliser son environnement de travail. Je ne vois pas comment une section d'exemples peut remplacer cela ou ce que cela apportera de plus.
Enfin, des exemples bien sentis sont glissés ci et là (voir par exemple man zip et man rsync pour ce qui me vient en tête de suite) et il n'est pas besoin d'avoir une section dédiée qui n'apporterait rien.
"It is seldom that liberty of any kind is lost all at once." ― David Hume
[^] # Re: Twitter
Posté par Gil Cot ✔ (site web personnel, Mastodon) . En réponse au lien Histoire des pages de man chez Sun. Évalué à 1.
Merci beaucoup : c'est bien plus clair !
Du coup, pour en revenir au sujet, une section EXEMPLES (je traduis en français) fait rarement sens pour être systématisé... Je vais de préciser un peu mon propos.
Que faudrait-il mettre comme exemples dans
man lsouman cpouman mvpar exemple ? Comme elle dit à un moment, on apprend à travers un livre (ou aujourd'hui un site interactif, ou généralement accompagné de quelqu'un) pour surtout pratiquer. Et tous les cas qu'on va pratiquer se ramènent au synopsis de la commande ; que faut-il de plus ? (question sérieuse) Perso, le premier usage que j'ai dumanc'est pour m'assurer/remémorer l'ordre des arguments.Mon second usage est pour trouver la bascule qui va bien. Là, j'aime bien qu'il y ait la liste dans une section dédiée. Normalement la description de chacune devrait se suffire. Là aussi, je ne vois pas ce qu'une section d'exemples ferait en plus : les fois où j'en ai vu, ça me semblait toujours trivial et surtout il n'y a pas l'exemple qui correspond à ce que je recherchais, mais on ne peut illustrer toutes les combinaisons de bascules possibles... Non, le mieux reste encore qu'au niveau de chaque option il y ait le rappel des options conflictuelles les mentions de combinaisons problématiques. (par exemple
-Hvs-Ldans le traitement des liens symboliques.)Elle compare, à juste titre, avec un dictionnaire, et dit elle-même que ce n'est pas l'outil adéquat pour apprendre... On dirait qu'elle cherche une commande
learnouexampleque fournissent maintenant les programmes dit de cheatsheetIl y a d'autres sections que j'aime bien consulter quand j'écris des scripts parce-qu'il faut comprendre quelles variables d'environnement vont influer et quels sont les bogues et/ou limitations connues. Ces mêmes sections sont utiles en dehors du scripting, quand l'on veut personnaliser son environnement de travail. Je ne vois pas comment une section d'exemples peut remplacer cela ou ce que cela apportera de plus.
Enfin, des exemples bien sentis sont glissés ci et là (voir par exemple
man zipetman rsyncpour ce qui me vient en tête de suite) et il n'est pas besoin d'avoir une section dédiée qui n'apporterait rien."It is seldom that liberty of any kind is lost all at once." ― David Hume