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 <[email protected]> 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 <[email protected]>: >> >> 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 >> <[email protected]> wrote: >>> >>> On Sat, Dec 3, 2016 at 10:54 PM, Bruno Franco >>> <[email protected]> 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:[email protected]?subjectUnsubscribe >> >> > -- UNSUBSCRIBE: mailto:[email protected]?subject=Unsubscribe
