Re: [Tutor] Suggestions about documenting a function

2006-10-31 Thread Jorge Azedo
Thanks for all your help guys, but after trying to read just bits and pieces of the manual and not understanding a single sentence, much less a single chapter, I decided to just put this function on hold until I read the whole Tutorial from start to finish. I just hope it doesn't take to long..

Re: [Tutor] Suggestions about documenting a function

2006-10-31 Thread Alan Gauld
"Jorge Azedo" <[EMAIL PROTECTED]> wrote > import random > > def randomList(n1,n2,len): >'''n1-n2 range of numbers, len - length of the final list > >Returns a list''' Don't worry too much about writing the doc string to fit in the IDE hint box. Think more about how it will look when peop

Re: [Tutor] Suggestions about documenting a function

2006-10-30 Thread Jorge Azedo
Thanks for your help guys. It will take me some time to understand exactly what you suggested to fix the function (I'm still a newb at this) but thanks for your help. I'll keep you posted on the updates :) ___ Tutor maillist - Tutor@python.org http://

Re: [Tutor] Suggestions about documenting a function

2006-10-30 Thread John Fouhy
On 31/10/06, Jorge Azedo <[EMAIL PROTECTED]> wrote: > def randomList(n1,n2,len): > '''n1-n2 range of numbers, len - length of the final list > > Returns a list''' > > i=0 > rndlist=[] > if len > n2: > return 'The length of the list must be greater than n2' Comment --- t

Re: [Tutor] Suggestions about documenting a function

2006-10-30 Thread Luke Paireepinart
Jorge Azedo wrote: > I'm writing a function that generates a list with user defined length, > that consists only of non-repeating random integers in a user defined range. > Even I don't understand what I just wrote, so I'm just going to post the > code and an example of the results :P > > ## Test