Path: csiph.com!eternal-september.org!feeder.eternal-september.org!news.swapon.de!fu-berlin.de!uni-berlin.de!not-for-mail
From: Random832 <random832@fastmail.com>
Newsgroups: comp.lang.python
Subject: Re: Guido sees the light: PEP 8 updated
Date: Tue, 19 Apr 2016 10:05:48 -0400
Lines: 56
Message-ID: <mailman.17.1461074751.30862.python-list@python.org>
References: <5711c1b3$0$1596$c3e8da3$5496439d@news.astraweb.com> <dne6huFi9sfU1@mid.individual.net> <87shym6kpo.fsf@elektro.pacujo.net> <CAPTjJmrq-pFDGS14PE+FXx=B+fXBD-Pkqc9JdQrjULR9aXRSxg@mail.gmail.com> <mailman.43.1460795561.6324.python-list@python.org> <87h9f26ioa.fsf@elektro.pacujo.net> <1460809922.1918014.580580553.0AE05EE4@webmail.messagingengine.com> <CACwCsY5EG_RFHe8DMF4VStYCsSuO-gMC+KRx05q9=vu8aa3K9g@mail.gmail.com> <mailman.50.1460818461.6324.python-list@python.org> <878u0d7az5.fsf@elektro.pacujo.net> <CACwCsY5fLxQqG80POb=notQdC1T5crarf_aQ2VBkCT2fwZM-2Q@mail.gmail.com> <netsjl$quf$1@ger.gmane.org> <CAMB+yF0XcDSrPWPNYuwq7_99sas4eUoOJm7k-ymoFKDd85saow@mail.gmail.com> <mailman.151.1460986528.6324.python-list@python.org> <m18u0a1uxx.fsf@iKarel.lan> <a5f54de9-f1e7-4d37-a479-12c04728c84a@googlegroups.com> <93639142-6b82-4b8a-8bd0-7f4593e1f692@googlegroups.com> <1461036589.1221872.582808913.08A50F70@webmail.messagingengine.com> <mailman.160.1461036598.6324.python-list@python.org> <8b3aa2c6-4314-446a-a894-fe61451a373a@googlegroups.com> <1461039063.1234620.582832393.7B6F72B6@webmail.messagingengine.com> <mailman.161.1461039066.6324.python-list@python.org> <0536e5a3-793f-44b3-87cc-5743bcf2a6a9@googlegroups.com> <1461074748.2551319.583266185.15F4C348@webmail.messagingengine.com>
Mime-Version: 1.0
Content-Type: text/plain
Content-Transfer-Encoding: 7bit
In-Reply-To: <0536e5a3-793f-44b3-87cc-5743bcf2a6a9@googlegroups.com>
Precedence: list
Xref: csiph.com comp.lang.python:107327

On Tue, Apr 19, 2016, at 08:55, Rustom Mody wrote:
> > Like, it ends up looking like this:
> > 
> > if foo("what if it's a much longer condition"):                # comment
> >                                                  do something  #
> >                                                  comment2
> > 
> > There's no way to get this:
> > 
> > if foo("what if it's a much longer condition"):  # comment
> >     do something                                 # comment2
> 
> I get it looking quite nice if I put a tab between "foo" and "("
> Is that an acceptable solution?? Dunno...

No, because what if "foo" is much longer? You could put a tab after
"if", but that means while-blocks are indented further than if-blocks.
And that just delays the problem to the third indent block, you've got
to find something to line that up to.

if foo("blah blah blah"):       # comment
    if bar("etc etc etc etc"):  # comment
        do stuff                # comment

becomes

if foo  ("blah blah blah"):                        # comment
        if bar               ("etc etc etc etc"):  # comment
                             do stuff              # comment

Maybe what we really need is a way to _display_ a multiline comment at
the right margin (and hanging down for as many lines as it needs),
without having it baked into the source code that way.

Source file contains:
### Lorem ipsum dolor sit amet, consectetur adipiscing elit. Etiam
### ut mattis leo. In sed arcu gravida, consequat tellus placerat,
### ullamcorper metus.
if foo:
    if bar:
        do stuff
###
some other stuff

(the last ### is just an empty comment to push stuff after it down past
the first comment - if another comment is there instead, it will be
displayed starting from the "some other stuff" line)

Displays as:

if foo:           # Lorem ipsum dolor sit amet, consectetur
    if bar:       # adipiscing elit. Etiam ut mattis leo. In sed
        do stuff  # arcu gravida, consequat tellus
                  # placerat, ullamcorper metus.

some other stuff