/* C-like multiline comments */

[bschubert (Brian Schubert)]

Previous proposal for /*-style comments:

Yet Another Multiline Comment Proposal

I know that Python does not support multi-line comments, because they can render the code unreadable. I have a proposal that could fix this problem. Consider this code: a = (1, 4, 7) for x in a: print(x) for i, y in enumerate(a): print("{}: {}".format(i+1, y)) I decide to comment the first for loop. Well, I could do this: a = (1, 4, 7) /* TODO fix it before restore it for x in a: print(x) */ for i, y in enumerate(a): print("{}: {}".format(i+1, y)) Notice that: a b…

Some other somewhat related comment proposals:

Structural comments

Idea Add syntax for structural comments to Python. This does not need to cover all structures initially, and can be contributed to iteratively. What are structural comments? A structural comment will mark a structure as a comment to the interpreter/compiler. For example: def vec_add(x, y): z = [] for i in range(0, min(len(x), len(y)): z.append(x[i] + y[i]) return z In this function, we have some example structures: The function scope itself; def ... Parameters for the function x…

Comment string literals (c-strings)

There are a lot of people that are looking for multiline comments: 2.1m here: docstring - How to comment out a block of code in Python - Stack Overflow 2.0m here: How do I create multiline comments in Python? - Stack Overflow Most commonly multi-line strings are used for this: print('Hello, world!') """The previous statement prints 'Hello, world!'.""" But pylint (rightfully) complaints about this: test.py:2:0: W0105: String statement has no effect (pointless-string-statement) Additiona…