Hey guys, I just wanted to mention some issue with the current documentation of core.reducers. I wanted to do it in github but it seems it is not possible there. Hopefully somebody from the language team can open an issue and correct (improve) it.
There are actually two issues that I would like to report - There is a contradiction between the documentation mentioned here, <http://clojure.github.io/clojure/clojure.core-api.html#clojure.core.reducers/fold>with respect to the one mentioned here <http://clojure.org/reference/reducers>. Specifically on the line that states "(with a seed value obtained by calling (combinef) with no arguments)" on the former and "The reducef function will be called with no arguments to produce an identity value *in each partition*." on the later. those two documentation references are contradictory. Either combinef is called with no arguments or reducef is called with no arguments. - The second doc issue is regarding the arities of most functions in core.reducers. With the introduction of transducers in Clojure 1.7. The single arity in functions like r/map or r/filter gives the impression that they return a transducer, whereas they just return a curried version of them. Nothing in the docstrings or the reference page mentions what is the return value of those functions with a single argument. I hope it helps, -- You received this message because you are subscribed to the Google Groups "Clojure" group. To post to this group, send email to [email protected] Note that posts from new members are moderated - please be patient with your first post. To unsubscribe from this group, send email to [email protected] For more options, visit this group at http://groups.google.com/group/clojure?hl=en --- You received this message because you are subscribed to the Google Groups "Clojure" group. To unsubscribe from this group and stop receiving emails from it, send an email to [email protected]. For more options, visit https://groups.google.com/d/optout.
