>
> Users of clojure learn that pretty quickly. I've just learned it. Doc 
> doesn't help.


> user=> (doc apply)
>>
>> -------------------------
>>
>> clojure.core/apply
>>
>> ([f args] [f x args] [f x y args] [f x y z args] [f a b c d & args])
>>
>>   Applies fn f to the argument list formed by prepending intervening 
>>> arguments to args.
>>
>> nil
>>
>>
Clojure core docs are indeed terse and demand very careful reading, which 
can be quite uninviting to a newcomer. However, if you do read the one you 
quote very carefully, it says that it will apply *f* to the *argument list* 
formed 
as explained. This is exactly and unambiguously what it really does.

I should also add that the learning process in Clojure involves the docs *and 
the repl*. There is hardly a more direct path to knowledge than just typing 
in a line of code and seeing the result. This is why I never really felt 
any frustration with the core docs.

-- 
You received this message because you are subscribed to the Google
Groups "Clojure" group.
To post to this group, send email to clojure@googlegroups.com
Note that posts from new members are moderated - please be patient with your 
first post.
To unsubscribe from this group, send email to
clojure+unsubscr...@googlegroups.com
For more options, visit this group at
http://groups.google.com/group/clojure?hl=en

Reply via email to