Re: Python (was Re: I did not inhale)

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?