PEP 350: Codetags

[Bruno Widmann]

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")