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

Re: verbs in comments [OT]

2012-03-24 Thread Roy Smith
In article , Chris Angelico 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 > code in the second form ("this is what this code does"), but b

Re: verbs in comments [OT]

2012-03-24 Thread Chris Angelico
On Sun, Mar 25, 2012 at 7:32 AM, Colton Myers 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. >  It's also a ha

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 f

Re: verbs in comments [OT]

2012-03-24 Thread Frederick Grose
On Sat, Mar 24, 2012 at 4:24 PM, 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

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

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 imper

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