Liste des Groupes | Revenir à cu shell |
In comp.unix.programmer David Brown <david.brown@hesbynett.no> wrote:If you have some code that needs a lot of documentation (and some does), then put the comments in a place that does not interfere with reading and understanding the code. Comments that make code harder to read are counter-productive.>It may not be "common" (ie, not a lot of languages have this requirement),
It is not common to have to have indent comment lines (certainly in
Python it is not necessary). And if you find yourself writing large
comments in the middle of a block in the middle of a function, it is
probably time to consider re-organising the code and/or the comments and
documentation. (Again, there can be exceptions to this general rule.)
>
but if it's your job to maintain a project written in such a language,
then you'll have to deal with that problem every single day.
Les messages affichés proviennent d'usenet.