Re: Incomplete documentation on 'need'

2016-12-03 Thread Alexander Burger
Hi all, On Sat, Dec 03, 2016 at 07:12:59PM -0500, Joe Bogner wrote: > Perhaps an additional example would be useful in the docs, but it's > easy enough to try in the repl Thanks Joe! I added one more example. ♪♫ Alex -- UNSUBSCRIBE: mailto:picolisp@software-lab.de?subject=Unsubscribe

Re: Incomplete documentation on 'need'

2016-12-03 Thread Bruno Franco
I got it! Yes! Thank you Joh. You too Joe, your example helped me a lot! It really was in the documentation, I just missed it because the opening paragraph didn't say it explicitly. I guess this is the kind of mistakes that come from lack of experience. So, as recap: the 'any argument is the

Re: Incomplete documentation on 'need'

2016-12-03 Thread Joe Bogner
Hi Bruno, welcome! I agree the documentation is terse, but I think it's clear. "When lst is given, it is extended to the left (if cnt is positive) or (destructively) to the right (if cnt is negative) with any elements" Here's an example Perhaps an additional example would be useful in the

Re: Incomplete documentation on 'need'

2016-12-03 Thread Joh-Tob Schäg
You are welcome. But from my personal experience the documentation is rather terse and changes happen not that often. Also (doc 'need) does state what it does do. Read the last two lines `second form`. It is very unclear and i hope Regenaxer takes a look and clarifies it. 2016-12-03 23:41

Re: Incomplete documentation on 'need'

2016-12-03 Thread Christophe Gragnic
On Sat, Dec 3, 2016 at 10:54 PM, Bruno Franco wrote: > I just wanted to point out that (doc 'need) for version 15.11.0 seems to > miss something. > […] > I also wanted to ask if this kind of topic was appropriate for the mailing > list. It seems so small that I

Incomplete documentation on 'need'

2016-12-03 Thread Bruno Franco
I just wanted to point out that (doc 'need) for version 15.11.0 seems to miss something. It defines the possible arguments of need as: (need 'cnt ['lst ['any]]) But it doesn't say what the function does with 'any, or how it affects the result. I also wanted to ask if this kind of topic was