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 docs, but it's easy enough to try in the repl # extend with NIL, same as (need 5) : (need 5 '(1 2)) -> (NIL NIL NIL 1 2) # extend with a (1 2) with 3 1s : (need 5 '(1 2) 1) -> (1 1 1 1 2) On Sat, Dec 3, 2016 at 5:59 PM, Joh-Tob Schäg <johtob...@gmail.com> wrote: > 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 GMT+01:00 Bruno Franco <brunofrancosala...@gmail.com>: >> >> Thanks Chri! I'm relieved to hear you say that. I'll make sure to send any >> question I have. >> >> On Sat, Dec 3, 2016 at 5:12 PM, Christophe Gragnic >> <christophegrag...@gmail.com> wrote: >>> >>> On Sat, Dec 3, 2016 at 10:54 PM, Bruno Franco >>> <brunofrancosala...@gmail.com> 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 wouldn't want to bother everyone just to >>> > point it out. >>> >>> I can't say anything about 'need, but I can answer the last question. >>> This list is very friendly, especially with newbies. >>> You can ask any question or point us to anything. >>> >>> >>> chri >>> -- >>> UNSUBSCRIBE: mailto:firstname.lastname@example.org?subjectUnsubscribe >> >> > -- UNSUBSCRIBE: mailto:email@example.com?subject=Unsubscribe