Re: verbs in comments [OT]

2012-03-26 Thread Jean-Michel Pichavant
Kiuhnm wrote: Why do you write // Print the number of words... def printNumWords(): ... and not // Prints the number of words... def printNumWords(): ... where it is understood? Is that an imperative or a base form or something else? Kiuhnm http://www.python.org/dev/peps/pep-0257/

verbs in comments [OT]

2012-03-24 Thread Kiuhnm
Why do you write // Print the number of words... def printNumWords(): ... and not // Prints the number of words... def printNumWords(): ... where it is understood? Is that an imperative or a base form or something else? Kiuhnm -- http://mail.python.org/mailman/listinfo/python-list

Re: verbs in comments [OT]

2012-03-24 Thread MRAB
On 24/03/2012 19:36, Kiuhnm wrote: Why do you write // Print the number of words... def printNumWords(): ... and not // Prints the number of words... def printNumWords(): ... where it is understood? Is that an imperative or a base form or something else? The first is the

Re: verbs in comments [OT]

2012-03-24 Thread Colton Myers
Why do you write // Print the number of words... def printNumWords(): ... and not // Prints the number of words... def printNumWords(): ... where it is understood? Is that an imperative or a base form or something else? I've seen it both ways, and I don't think anyone will fault you

Re: verbs in comments [OT]

2012-03-24 Thread Frederick Grose
On Sat, Mar 24, 2012 at 4:24 PM, MRAB pyt...@mrabarnett.plus.com wrote: On 24/03/2012 19:36, Kiuhnm wrote: Why do you write // Print the number of words... def printNumWords(): ... and not // Prints the number of words... def printNumWords(): ... where it is understood? Is

Re: verbs in comments [OT]

2012-03-24 Thread Kiuhnm
On 3/24/2012 21:24, MRAB wrote: On 24/03/2012 19:36, Kiuhnm wrote: Why do you write // Print the number of words... def printNumWords(): ... and not // Prints the number of words... def printNumWords(): ... where it is understood? Is that an imperative or a base form or something else? The

Re: verbs in comments [OT]

2012-03-24 Thread Chris Angelico
On Sun, Mar 25, 2012 at 7:32 AM, Colton Myers colton.my...@gmail.com wrote: // Print the number of words... // Prints the number of words... I've seen it both ways, and I don't think anyone will fault you for either.  I usually use the first version, commanding the code to do what I want.  

Re: verbs in comments [OT]

2012-03-24 Thread Roy Smith
In article mailman.961.1332628608.3037.python-l...@python.org, Chris Angelico ros...@gmail.com wrote: It's funny how these things go. There are multiple distinct conventions, and regarding function definition comments (or docstrings), both of those do definitely exist. I think I've seen more