Des exemples seraient bienvenues pour des commandes un peu plus complexes (grep, sed, ...)
Je répondais dans un autre commentaire que jeTM ne les trouve pas toujours utiles même si OpenBSD par exemple s'efforce d'en mettre, alors que chez AT&T ce n'était pas le cas (je n'ai pas vérifié mais c'est ce que mentionne le tweet : Sun avait suivi l'autre voie avant de revirer vers l'originale comme le fait Linux sur ce point, perdant du coup les sections d'exemples.)
Il se trouve que les exemples que tu mentionnes ont déjà des pages fort longues et ont fait couler de l'encre (au sens où il existe des livres de centaines de pages dont la moitié est fait d'exemples.) Peut-être qu'il aurait fallu des manpages dédiés aux exemples dans ce cas ?
On en trouve pas mal dans la documentation de Linux proprement dit (epoll, par exemple) et des APIs de systemd (sd_notify, les APIs pour récupérer les logs de journalctl). Dans ces cas là il n'y a en général aucune autre documentation disponible, et quand la page de man n'existe pas ou ne donne pas d'exemple, ça devient vite compliqué.
Oui, ma réponse faisait surtout référence aux rayons 1, 4, 5 et 7. Sous Linux, ou plus précisément pour les outils GNU, la tendance est d'avoir une page (de man) minimaliste pour faire office de mémento, et d'avoir un manuel utilisateur plus complet accessible en ligne (sur le site du projet) ou localement avec le système TextInfo. Là c'est effectivement assez riche pour rivaliser avec les équivalents papier O'reilly et autres.
Pour les rayons 2, 3 et souvent 4, (cas de epoll que tu cites) il y a en effet la plupart du temps les modèles types de code ...qui pour ne sont pas toujours juste des exemples (dans le sens que je crois comprendre du post tweeter qui serait des trucs à copier-coller tel-quels.)
Mais je te rejoins sur le fait que la manpage doit être systématique pour eux (comme au bon vieux temps...)
"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.
Je répondais dans un autre commentaire que jeTM ne les trouve pas toujours utiles même si OpenBSD par exemple s'efforce d'en mettre, alors que chez AT&T ce n'était pas le cas (je n'ai pas vérifié mais c'est ce que mentionne le tweet : Sun avait suivi l'autre voie avant de revirer vers l'originale comme le fait Linux sur ce point, perdant du coup les sections d'exemples.)
Il se trouve que les exemples que tu mentionnes ont déjà des pages fort longues et ont fait couler de l'encre (au sens où il existe des livres de centaines de pages dont la moitié est fait d'exemples.) Peut-être qu'il aurait fallu des manpages dédiés aux exemples dans ce cas ?
Oui, ma réponse faisait surtout référence aux rayons 1, 4, 5 et 7. Sous Linux, ou plus précisément pour les outils GNU, la tendance est d'avoir une page (de man) minimaliste pour faire office de mémento, et d'avoir un manuel utilisateur plus complet accessible en ligne (sur le site du projet) ou localement avec le système TextInfo. Là c'est effectivement assez riche pour rivaliser avec les équivalents papier O'reilly et autres.
Pour les rayons 2, 3 et souvent 4, (cas de epoll que tu cites) il y a en effet la plupart du temps les modèles types de code ...qui pour ne sont pas toujours juste des exemples (dans le sens que je crois comprendre du post tweeter qui serait des trucs à copier-coller tel-quels.)
Mais je te rejoins sur le fait que la manpage doit être systématique pour eux (comme au bon vieux temps...)
"It is seldom that liberty of any kind is lost all at once." ― David Hume