Re: TODO and FIXME tags

2009-11-20 Thread Marco Mariani

Jean-Michel Pichavant wrote:

I guess the world is split in two categories, those how come back to fix 
the TODO, and those how don't. I for myself belong to the second, that 
is why I never write TODO comments, I either do the stuff or consider 
this is not important enough to waste time on it. In other words I 
mostly agree with Martin, and envy people belonging to the first category.


I am in a third category, I added this line to my python.vim syntax file

syn keyword pythonTodo  WTF LOL SNAFU contained

and envy those who didn't :)
--
http://mail.python.org/mailman/listinfo/python-list


Re: TODO and FIXME tags

2009-11-18 Thread Jean-Michel Pichavant

Scott David Daniels wrote:

Martin P. Hellwig wrote:

Ben Finney wrote:

Chris Rebert c...@rebertia.com writes:


2009/11/16 Yasser Almeida Hernández pedro...@fenhi.uh.cu:

How is the sintaxis for set the TODO and FIXME tags...?

...

There's no widely-followed “syntax” for this convention, though.
Except for _not_ doing what is suggested in those comments, which 
appears to be the biggest convention :-)


Perhaps: The comments are a directive to delete the comment if
you happen do this.

--Scott David Daniels
scott.dani...@acm.org
I guess the world is split in two categories, those how come back to fix 
the TODO, and those how don't. I for myself belong to the second, that 
is why I never write TODO comments, I either do the stuff or consider 
this is not important enough to waste time on it. In other words I 
mostly agree with Martin, and envy people belonging to the first category.


JM
--
http://mail.python.org/mailman/listinfo/python-list


TODO and FIXME tags

2009-11-17 Thread Yasser Almeida Hernández

Hi all..
Sorry if this question sound elemental.
How is the sintaxis for set the TODO and FIXME tags...?

Thanks

--
Lic. Yasser Almeida Hernández
Center of Molecular Inmunology (CIM)
Nanobiology Group
P.O.Box 16040, Havana, Cuba
Phone: (537) 271-7933, ext. 221


Correo FENHI



--
http://mail.python.org/mailman/listinfo/python-list


Re: TODO and FIXME tags

2009-11-17 Thread Chris Rebert
2009/11/16 Yasser Almeida Hernández pedro...@fenhi.uh.cu:
 Hi all..
 Sorry if this question sound elemental.
 How is the sintaxis for set the TODO and FIXME tags...?

There is no special syntax for those. Some people use them in
comments, but it's just a convention.

Cheers,
Chris
--
http://blog.rebertia.com
-- 
http://mail.python.org/mailman/listinfo/python-list


Re: TODO and FIXME tags

2009-11-17 Thread Ben Finney
Chris Rebert c...@rebertia.com writes:

 2009/11/16 Yasser Almeida Hernández pedro...@fenhi.uh.cu:
  How is the sintaxis for set the TODO and FIXME tags...?

 There is no special syntax for those. Some people use them in
 comments, but it's just a convention.

This is true. However, the convention is fairly well established, and
many text editor default configurations will highlight the strings
‘TODO’, ‘FIXME’, and others wherever they appear in comments.

There's no widely-followed “syntax” for this convention, though.

-- 
 \ “I must say that I find television very educational. The minute |
  `\   somebody turns it on, I go to the library and read a book.” |
_o__)—Groucho Marx |
Ben Finney
-- 
http://mail.python.org/mailman/listinfo/python-list


Re: TODO and FIXME tags

2009-11-17 Thread Martin P. Hellwig

Ben Finney wrote:

Chris Rebert c...@rebertia.com writes:


2009/11/16 Yasser Almeida Hernández pedro...@fenhi.uh.cu:

How is the sintaxis for set the TODO and FIXME tags...?

There is no special syntax for those. Some people use them in
comments, but it's just a convention.


This is true. However, the convention is fairly well established, and
many text editor default configurations will highlight the strings
‘TODO’, ‘FIXME’, and others wherever they appear in comments.

There's no widely-followed “syntax” for this convention, though.



Except for _not_ doing what is suggested in those comments, which 
appears to be the biggest convention :-)


--
MPH
http://blog.dcuktec.com
'If consumed, best digested with added seasoning to own preference.'
--
http://mail.python.org/mailman/listinfo/python-list


Re: TODO and FIXME tags

2009-11-17 Thread Falcolas
On Nov 17, 4:27 am, Martin P. Hellwig martin.hell...@dcuktec.org
wrote:
 Ben Finney wrote:
  Chris Rebert c...@rebertia.com writes:

  2009/11/16 Yasser Almeida Hernández pedro...@fenhi.uh.cu:
  How is the sintaxis for set the TODO and FIXME tags...?
  There is no special syntax for those. Some people use them in
  comments, but it's just a convention.

  This is true. However, the convention is fairly well established, and
  many text editor default configurations will highlight the strings
  ‘TODO’, ‘FIXME’, and others wherever they appear in comments.

  There's no widely-followed “syntax” for this convention, though.

I have noticed that within Python XXX as an identifier is fairly
popular as well - it's used throughout the standard libraries, and is
recognized by many syntax highlighting schemes, as well as Pylint.

Garrick
-- 
http://mail.python.org/mailman/listinfo/python-list


Re: TODO and FIXME tags

2009-11-17 Thread Scott David Daniels

Martin P. Hellwig wrote:

Ben Finney wrote:

Chris Rebert c...@rebertia.com writes:


2009/11/16 Yasser Almeida Hernández pedro...@fenhi.uh.cu:

How is the sintaxis for set the TODO and FIXME tags...?

...

There's no widely-followed “syntax” for this convention, though.
Except for _not_ doing what is suggested in those comments, which 
appears to be the biggest convention :-)


Perhaps: The comments are a directive to delete the comment if
you happen do this.

--Scott David Daniels
scott.dani...@acm.org
--
http://mail.python.org/mailman/listinfo/python-list