PEP 350: Codetags
Bruno Widmann
bwidmann at utanet.at
Wed Sep 28 04:47:08 EDT 2005
On 2005-09-26, Micah Elliott <mde at micah.elliott.name> wrote:
>
> :Objection: I aesthetically dislike for the comment to be terminated
> with <> in the empty field case.
>
> :Defense: It is necessary to have a terminator since codetags may be
> followed by non-codetag comments. Or codetags could be limited to
> a single line, but that's prohibitive. I can't think of any
> single-character terminator that is appropriate and significantly
> better than <>. Maybe ``@`` could be a terminator, but then most
> codetags will have an unnecessary @.
>
> ----
What about allowing a blank line between codetag and following
comment as valid terminator of codetag?
ie:
# NOTE: see spec xyz for Transport Protocol description
# how many times to retry open of a recordset
DB_OPEN_RETRYS = 3
Also if the codetag is immediatly followed by code,
all the commentlines from start of the tag to
the beginning of code could be considered part of
the codetag.
# TODO: catch possible exception here
# (in case someone deletes file)
f = open("data")
More information about the Python-list
mailing list