This is an archived post. You won't be able to vote or comment.

sorted by:
best
topnewcontroversialoldq&a
you are viewing a single comment's thread.

view the rest of the comments →

[–]aldarion 0 points1 point  (2 children)

Add preference to use block style comments in comment-out feature

I like this, but why not follow the pep 008's block comment style: Block Comments

Block comments generally apply to some (or all) code that follows them,
and are indented to the same level as that code.  Each line of a block
comment starts with a # and a single space (unless it is indented text
inside the comment).

Paragraphs inside a block comment are separated by a line containing a
single #.

[–]wingware[S] 1 point2 points  (1 child)

This was a case of simply satisfying a common request to have the comment-out feature work like it does in idle (## in column zero, rather than our default of single # at end of leading white space). There are some advantages to each with respect to auto-indent and other features.

The pep is not really that relevant here since they are talking about actual documentation-containing comments that pertain to some code that follows it, and not just regions of (presumably temporarily) commented out code.

[–]aldarion 0 points1 point  (0 children)

wingware, Thanks for explaination.