- Pourquoi les BSD ont generalement une doc a jour et complete ?
-> un des petits plaisirs sadique du BSDiste consiste a envoyer chier
le debutant, de preference avec un RTFM bien senti. Parfois, il y a un
bug: la doc prevue pour le RTFM n'existe pas, ou n'est pas a jour.
Dans ce cas le BSDiste consciencieux et prevoyant s'empeche de mettre
la doc a jour afin de pouvoir s'en reservir la prochaine fois. S'il est
de bonne humeur, il consent a expliquer au debutant ce qui se passe.
Le BSDiste particulierement sadique s'efforcera de rajouter des liens
aux endroits idoines de facon a pouvoir bien montrer au debutant qu'il
est VRAIMENT stupide d'etre systematiquement passe a travers tous les
liens.
A contraster avec le comportement du jeune linuxien servile, qui explique
tout ce qu'il a appris a qui veut l'entendre dans tout newsgroup, et qui
ne pense que tres rarement a mettre la doc a jour. Ca vaut mieux d'ailleurs:
comme il a lui-meme appris en posant des questions betes dans les news, le
rapport signal/bruit du resultat risquerait fort d'etre desastreux.
Il se produit parfois un CHOC CULTUREL, lorsqu'un windowsien debarque sur
un BSD, et decouvre qu'il peut avoir des logiciels sans les pirater^Wpayer.
Voire un linuxien, qui decouvre qu'il peut avoir une machine qui marche
sans recompiler n fois son noyau, sans mettre a jour trois millions de trucs,
et qui decouvre avec stupeur l'existence d'un outil obsolete (puisque c'est
RMS qui l'a dit) qui s'appelle `man'.
<no-troll> ça serait bien de voir sur _toutes_ les docs (limite sur chaque page) la date de derniere mise à jour. Comme dans tout document digne de nom.
Ceci dit, lorsqu'on voit une doc, et meme si elle est datée, comment savoir si elle est encore valable?
</no-troll>
Stéphane
<no-troll>
ça serait bien de voir sur _toutes_ les docs (limite sur chaque page) la
date de derniere mise à jour. Comme dans tout document digne de nom.
Ceci dit, lorsqu'on voit une doc, et meme si elle est datée, comment savoir
si elle est encore valable?
<no-troll> ça serait bien de voir sur _toutes_ les docs (limite sur chaque page) la date de derniere mise à jour. Comme dans tout document digne de nom.
Ceci dit, lorsqu'on voit une doc, et meme si elle est datée, comment savoir si elle est encore valable?
</no-troll>
Stéphane
Stéphane
ça serait bien de voir sur _toutes_ les docs (limite sur chaque page) la date de derniere mise à jour. Comme dans tout document digne de nom.
non c'est pas pour etre ISO-9002 ;-) .. quoique l'idée n'est pas mauvaise ..
ça serait bien de voir sur _toutes_ les docs (limite sur chaque page) la
date de derniere mise à jour. Comme dans tout document digne de nom.
non c'est pas pour etre ISO-9002 ;-) .. quoique l'idée n'est pas mauvaise ..
ça serait bien de voir sur _toutes_ les docs (limite sur chaque page) la date de derniere mise à jour. Comme dans tout document digne de nom.
C'est fait avec plus ou moins de sérieux sur les pages de manuel (sauf pour des corrections mineures qui ne modifient pas le texte).
Tiens, j'ai une ambiguite a lever, en mandoc, ca dit: .Dd Month day, year Document date.
c'est pas tres precis. On veut la date de creation, la date de mise a jour, ou quoi ?
Jusqu'ici j'ai toujours mis une date a la creation du document et je n'y ai jamais retouche depuis...
Miod Vallat
C'est fait avec plus ou moins de sérieux sur les pages de manuel (sauf pour des corrections mineures qui ne modifient pas le texte).
Tiens, j'ai une ambiguite a lever, en mandoc, ca dit: .Dd Month day, year Document date.
c'est pas tres precis. On veut la date de creation, la date de mise a jour, ou quoi ?
Il n'y a pas de régle écrite a ma connaissance, mais l'usage le plus raisonnable qu'on puisse en trouver est le suivant : - à la création : date d'écriture du document - après une modification qui laisse le texte «inchangé» (correction d'orthographe, modifications de formattage...) : pas de modification - après une modification qui modifie (sic) le texte (description de nouvelles fonctionnalités, changement de sémantique, etc) : date de révision (le plus souvent, la date du jour).
Évidemment, définir en quoi consiste une modification est assez flou. Par exemple, chez OpenBSD, si on rajoute une ligne de synopsis à wsdisplay(4) parce qu'un nouveau pilote a été développé, la date ne change pas : on ne considère pas cette modification comme pertinente. Chez NetBSD, la date serait mise à jour (il faut dire qu'il y a un mdoc nazi chez NetBSD).
C'est fait avec plus ou moins de sérieux sur les pages de manuel (sauf
pour des corrections mineures qui ne modifient pas le texte).
Tiens, j'ai une ambiguite a lever, en mandoc, ca dit:
.Dd Month day, year Document date.
c'est pas tres precis. On veut la date de creation, la date de mise a jour,
ou quoi ?
Il n'y a pas de régle écrite a ma connaissance, mais l'usage le plus
raisonnable qu'on puisse en trouver est le suivant :
- à la création : date d'écriture du document
- après une modification qui laisse le texte «inchangé» (correction
d'orthographe, modifications de formattage...) : pas de modification
- après une modification qui modifie (sic) le texte (description de
nouvelles fonctionnalités, changement de sémantique, etc) : date de
révision (le plus souvent, la date du jour).
Évidemment, définir en quoi consiste une modification est assez flou.
Par exemple, chez OpenBSD, si on rajoute une ligne de synopsis à
wsdisplay(4) parce qu'un nouveau pilote a été développé, la date ne
change pas : on ne considère pas cette modification comme pertinente.
Chez NetBSD, la date serait mise à jour (il faut dire qu'il y a un mdoc
nazi chez NetBSD).
C'est fait avec plus ou moins de sérieux sur les pages de manuel (sauf pour des corrections mineures qui ne modifient pas le texte).
Tiens, j'ai une ambiguite a lever, en mandoc, ca dit: .Dd Month day, year Document date.
c'est pas tres precis. On veut la date de creation, la date de mise a jour, ou quoi ?
Il n'y a pas de régle écrite a ma connaissance, mais l'usage le plus raisonnable qu'on puisse en trouver est le suivant : - à la création : date d'écriture du document - après une modification qui laisse le texte «inchangé» (correction d'orthographe, modifications de formattage...) : pas de modification - après une modification qui modifie (sic) le texte (description de nouvelles fonctionnalités, changement de sémantique, etc) : date de révision (le plus souvent, la date du jour).
Évidemment, définir en quoi consiste une modification est assez flou. Par exemple, chez OpenBSD, si on rajoute une ligne de synopsis à wsdisplay(4) parce qu'un nouveau pilote a été développé, la date ne change pas : on ne considère pas cette modification comme pertinente. Chez NetBSD, la date serait mise à jour (il faut dire qu'il y a un mdoc nazi chez NetBSD).
espie
In article <40f2815c$0$24438$, Miod Vallat wrote:
Chez NetBSD, la date serait mise à jour (il faut dire qu'il y a un mdoc nazi chez NetBSD).
Tiens, faudra demander a jmc ce qu'il en pense, a l'occasion. Je soupconne qu'il n'est pas au courant, vu les trucs qui le font tiquer d'habitude. ;-)
In article <40f2815c$0$24438$636a15ce@news.free.fr>,
Miod Vallat <miod@online.fr> wrote:
Chez NetBSD, la date serait mise à jour (il faut dire qu'il y a un mdoc
nazi chez NetBSD).
Tiens, faudra demander a jmc ce qu'il en pense, a l'occasion.
Je soupconne qu'il n'est pas au courant, vu les trucs qui le font
tiquer d'habitude. ;-)
