--
Car avec beaucoup de science, il y a beaucoup de chagrin ; et celui qui
accroît sa science accroît sa douleur.
[Ecclésiaste, 1-18]
MELMOTH - souffrant
Aéris , dans le message <4e74af4a$0$28898$, a écrit :
Normes Java =)
Ce n'est pas une excuse.
Au moins ça a l'avantage de distinguer du 1er coup d'œil si c'est du constant ou non.
Toutes les conventions raisonnables le permettent.
Qu'est ce qu'elle a ma gueule ?
On Sat, 17 Sep 2011 16:02:37 +0200, Aéris wrote:
-----BEGIN PGP SIGNED MESSAGE----- Hash: SHA1
Le 17/09/2011 15:47, Qu'est ce qu'elle a ma gueule ? a écrit :
Ça c'est un commentaire mal gaulé. Par contre pour expliquer qu'on compense un décalage de colonne dans un array c'est different.
En quoi j'ai besoin du moindre commentaire ? Un code bien gaulé est largement suffisant… currentColumn += COLUMN_OFFSET Et à la limite, ça évitera même de se poser des questions de la présence du « - » si l'offset devient négatif !
Maintenant c'est plus clair que ton i +=1
Sachant en plus qu'il vaut mieux du code bien gaulé que du commentaire bien gaulé. Parce que le commentaire bien gaulé, fortes chances qu'il devienne mal gaulé à la prochaine modif…
Le commentaire peut être intégré au code. Comme tu viens de le faire en remplacant le i par une variable explicite.
Ce qui n'est pas toujours le cas.
-- « le politiquement correct ne proclame pas la tolérance ; il ne fait qu'organiser la haine. » (Jacques Barzun) C'est une doctrine obligatoire, qui n'est en réalité que l'expression la plus autoritaire du conformisme
On Sat, 17 Sep 2011 16:02:37 +0200, Aéris <aeris@imirhil.fr> wrote:
-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1
Le 17/09/2011 15:47, Qu'est ce qu'elle a ma gueule ? a écrit :
Ça c'est un commentaire mal gaulé.
Par contre pour expliquer qu'on compense un décalage de colonne dans
un array c'est different.
En quoi j'ai besoin du moindre commentaire ?
Un code bien gaulé est largement suffisant…
currentColumn += COLUMN_OFFSET
Et à la limite, ça évitera même de se poser des questions de la présence
du « - » si l'offset devient négatif !
Maintenant c'est plus clair que ton i +=1
Sachant en plus qu'il vaut mieux du code bien gaulé que du commentaire
bien gaulé. Parce que le commentaire bien gaulé, fortes chances qu'il
devienne mal gaulé à la prochaine modif…
Le commentaire peut être intégré au code. Comme tu viens de le faire
en remplacant le i par une variable explicite.
Ce qui n'est pas toujours le cas.
--
« le politiquement correct ne proclame pas la tolérance ; il ne fait qu'organiser la haine. » (Jacques Barzun)
C'est une doctrine obligatoire, qui n'est en réalité que l'expression la plus autoritaire du conformisme
Le 17/09/2011 15:47, Qu'est ce qu'elle a ma gueule ? a écrit :
Ça c'est un commentaire mal gaulé. Par contre pour expliquer qu'on compense un décalage de colonne dans un array c'est different.
En quoi j'ai besoin du moindre commentaire ? Un code bien gaulé est largement suffisant… currentColumn += COLUMN_OFFSET Et à la limite, ça évitera même de se poser des questions de la présence du « - » si l'offset devient négatif !
Maintenant c'est plus clair que ton i +=1
Sachant en plus qu'il vaut mieux du code bien gaulé que du commentaire bien gaulé. Parce que le commentaire bien gaulé, fortes chances qu'il devienne mal gaulé à la prochaine modif…
Le commentaire peut être intégré au code. Comme tu viens de le faire en remplacant le i par une variable explicite.
Ce qui n'est pas toujours le cas.
-- « le politiquement correct ne proclame pas la tolérance ; il ne fait qu'organiser la haine. » (Jacques Barzun) C'est une doctrine obligatoire, qui n'est en réalité que l'expression la plus autoritaire du conformisme
Aéris
-----BEGIN PGP SIGNED MESSAGE----- Hash: SHA1
Le 17/09/2011 17:45, Qu'est ce qu'elle a ma gueule ? a écrit :
Le commentaire peut être intégré au code. Comme tu viens de le faire en remplacant le i par une variable explicite.
Ce qui n'est pas toujours le cas.
Certes, mais qui l'est très généralement. Au bas mot, 80 à 90% du temps.
Quant à en arriver à avoir 50% code et 50% commentaire comme il en a été mention ici, ça n'augure rien de bon sur la qualité de l'application. Rien qu'en difficulté de relecture et de compréhension globale, OMG…
- -- Aeris -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.4.11 (GNU/Linux) Comment: Using GnuPG with Mozilla - http://enigmail.mozdev.org/
Le 17/09/2011 17:45, Qu'est ce qu'elle a ma gueule ? a écrit :
Le commentaire peut être intégré au code. Comme tu viens de le faire
en remplacant le i par une variable explicite.
Ce qui n'est pas toujours le cas.
Certes, mais qui l'est très généralement.
Au bas mot, 80 à 90% du temps.
Quant à en arriver à avoir 50% code et 50% commentaire comme il en a été
mention ici, ça n'augure rien de bon sur la qualité de l'application.
Rien qu'en difficulté de relecture et de compréhension globale, OMG…
- --
Aeris
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.11 (GNU/Linux)
Comment: Using GnuPG with Mozilla - http://enigmail.mozdev.org/
Le 17/09/2011 17:45, Qu'est ce qu'elle a ma gueule ? a écrit :
Le commentaire peut être intégré au code. Comme tu viens de le faire en remplacant le i par une variable explicite.
Ce qui n'est pas toujours le cas.
Certes, mais qui l'est très généralement. Au bas mot, 80 à 90% du temps.
Quant à en arriver à avoir 50% code et 50% commentaire comme il en a été mention ici, ça n'augure rien de bon sur la qualité de l'application. Rien qu'en difficulté de relecture et de compréhension globale, OMG…
- -- Aeris -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.4.11 (GNU/Linux) Comment: Using GnuPG with Mozilla - http://enigmail.mozdev.org/
Ce cher mammifère du nom de Jean-Claude BELLAMY nous susurrait, le vendredi 16/09/2011, dans nos oreilles grandes ouvertes mais un peu sales tout de même, et dans le message <4e738c3f$0$30778$, les doux mélismes suivants :
Donc j'aurais préféré : - soit un exposé rapide, qui n'entre pas dans les détails, et pour lequel on accepte quelques approximations. - soit un exposé complet, mais dans ce cas rigoureux, sans erreur et objectif.
Mon Bon...Je n'ai jamais affirmé que Je cautionnais ce genre de discours !...
-- Car avec beaucoup de science, il y a beaucoup de chagrin ; et celui qui accroît sa science accroît sa douleur. [Ecclésiaste, 1-18] MELMOTH - souffrant
Ce cher mammifère du nom de Jean-Claude BELLAMY nous susurrait, le
vendredi 16/09/2011, dans nos oreilles grandes ouvertes mais un peu
sales tout de même, et dans le message
<4e738c3f$0$30778$ba4acef3@reader.news.orange.fr>, les doux mélismes
suivants :
Donc j'aurais préféré :
- soit un exposé rapide, qui n'entre pas dans les détails, et pour
lequel on accepte quelques approximations.
- soit un exposé complet, mais dans ce cas rigoureux, sans erreur et
objectif.
Mon Bon...Je n'ai jamais affirmé que Je cautionnais ce genre de
discours !...
--
Car avec beaucoup de science, il y a beaucoup de chagrin ; et celui qui
accroît sa science accroît sa douleur.
[Ecclésiaste, 1-18]
MELMOTH - souffrant
Ce cher mammifère du nom de Jean-Claude BELLAMY nous susurrait, le vendredi 16/09/2011, dans nos oreilles grandes ouvertes mais un peu sales tout de même, et dans le message <4e738c3f$0$30778$, les doux mélismes suivants :
Donc j'aurais préféré : - soit un exposé rapide, qui n'entre pas dans les détails, et pour lequel on accepte quelques approximations. - soit un exposé complet, mais dans ce cas rigoureux, sans erreur et objectif.
Mon Bon...Je n'ai jamais affirmé que Je cautionnais ce genre de discours !...
-- Car avec beaucoup de science, il y a beaucoup de chagrin ; et celui qui accroît sa science accroît sa douleur. [Ecclésiaste, 1-18] MELMOTH - souffrant
Nicolas George
Tonton Th , dans le message <4e75bfb2$0$20413$, a écrit :
Ça fait toujours un peu peur les tinyurl sans explications.
Tu avais le From qui te prévenait que ça n'avait aucun intérêt.
Tonton Th , dans le message <4e75bfb2$0$20413$426a74cc@news.free.fr>, a
écrit :
Ça fait toujours un peu peur les tinyurl sans explications.
Tu avais le From qui te prévenait que ça n'avait aucun intérêt.
Tonton Th , dans le message <4e75bfb2$0$20413$, a écrit :
Ça fait toujours un peu peur les tinyurl sans explications.
Tu avais le From qui te prévenait que ça n'avait aucun intérêt.
Stephane Catteau
Aéris devait dire quelque chose comme ceci :
Mais il faut reconnaitre que ce code source est remarquablement documenté. En gros c'est "une ligne de code -> une ligne de commentaire".
Quand on sait que les véritables professionnels de l'informatique soutiennent que « si vous avez besoin de mettre des commentaires, c'est que votre code est incompréhensible et mal gaulé »…
Dans un projet aussi gros qu'un OS, qui plus est avec GUI intégré, un bloc de commentaire résumant la fonction/sub, et listant les paramètres n'est pas synonyme de chaos dans le code, au contraire. D'ailleurs d'un point de vue sécurité ce n'est pas du superflu non plus, puisque cela permet une meilleure mise en perspective du code autant que des paramètres. De cette façon l'on oublie pas si l'on se trouve en amont ou en aval de certains traitements et donc si les données sont encore potentiellement corrompues, le code particulièrement exposé et ainsi de suite.
[snip la partie la plus énorme du troll]
Aéris devait dire quelque chose comme ceci :
Mais il faut reconnaitre que ce code source est remarquablement documenté.
En gros c'est "une ligne de code -> une ligne de commentaire".
Quand on sait que les véritables professionnels de l'informatique
soutiennent que « si vous avez besoin de mettre des commentaires, c'est
que votre code est incompréhensible et mal gaulé »…
Dans un projet aussi gros qu'un OS, qui plus est avec GUI intégré, un
bloc de commentaire résumant la fonction/sub, et listant les paramètres
n'est pas synonyme de chaos dans le code, au contraire.
D'ailleurs d'un point de vue sécurité ce n'est pas du superflu non
plus, puisque cela permet une meilleure mise en perspective du code
autant que des paramètres. De cette façon l'on oublie pas si l'on se
trouve en amont ou en aval de certains traitements et donc si les
données sont encore potentiellement corrompues, le code
particulièrement exposé et ainsi de suite.
Mais il faut reconnaitre que ce code source est remarquablement documenté. En gros c'est "une ligne de code -> une ligne de commentaire".
Quand on sait que les véritables professionnels de l'informatique soutiennent que « si vous avez besoin de mettre des commentaires, c'est que votre code est incompréhensible et mal gaulé »…
Dans un projet aussi gros qu'un OS, qui plus est avec GUI intégré, un bloc de commentaire résumant la fonction/sub, et listant les paramètres n'est pas synonyme de chaos dans le code, au contraire. D'ailleurs d'un point de vue sécurité ce n'est pas du superflu non plus, puisque cela permet une meilleure mise en perspective du code autant que des paramètres. De cette façon l'on oublie pas si l'on se trouve en amont ou en aval de certains traitements et donc si les données sont encore potentiellement corrompues, le code particulièrement exposé et ainsi de suite.
