[Python-Dev] PEP 350: Codetags

[Guido van Rossum]

On 9/26/05, Neil Schemenauer <nas at arctrix.com> wrote:
> Micah Elliott <mde at micah.elliott.name> wrote:
> > ``FIXME (XXX, DEBUG, BROKEN, REFACTOR, REFACT, RFCTR, OOPS, SMELL, NEEDSWORK, INSPECT)``
> >    *Fix me*: Areas of problematic or ugly code needing refactoring or
> >    cleanup.
>
> I think the standard should not have codetags that are synonyms.
> This is Python and there should be only one way to do it.  One
> problem with synonyms is that they makes it harder to search using
> tools like grep.

It has always been my choice to *only* use XXX. I hope there aren't
any developers contributing to the Python core who use any others? I
honestly don't see much of a point for distinguishing different types;
these are for humans to read and review, and different tags just makes
it harder to grep.

--
--Guido van Rossum (home page: http://www.python.org/~guido/)