Sujet : Re: Python (was Re: I did not inhale)
De : ldo (at) *nospam* nz.invalid (Lawrence D'Oliveiro)
Groupes : comp.unix.shell comp.unix.programmer comp.lang.miscDate : 27. Aug 2024, 22:40:19
Autres entêtes
Organisation : A noiseless patient Spider
Message-ID : <valh42$34s18$2@dont-email.me>
References : 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26
User-Agent : Pan/0.160 (Toresk; )
On Tue, 27 Aug 2024 20:46:27 +0200, David Brown wrote:
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.)
Counterexample: <
https://www.cairographics.org/cookbook/freetypepython/>
(Yes, that’s one of mine). Note the explanation of the user-data dance,
for backward compatibility with older FreeType. Where else would you put
the comments, if not next to the code they’re explaining?