GNU bug report logs - #24014
24.5; doc string of `cl-reduce'

Previous Next

Full log

View this message in rfc822 format

From: Drew Adams <drew.adams <at> oracle.com>
To: Clément Pit--Claudel <clement.pit <at> gmail.com>, 24014 <at> debbugs.gnu.org
Subject: bug#24014: 24.5; doc string of `cl-reduce'
Date: Mon, 18 Jul 2016 07:02:30 -0700 (PDT)

> > Even providing a functional-programming definition of `reduce' is
> > better than just describing it in abstract terms, if we can't come
> > up with a more down-to-earth description.
> 
> What about adding a few examples? Something like this maybe?
> 
>     (cl-reduce f '(1 2 3 4 5))
>       ↔ (f (f (f (f 1 2) 3) 4) 5)
> 
>     (cl-reduce f '(1 2 3 4 5) :initial-value 0)
>       ↔ (f (f (f (f (f 0 1) 2) 3) 4) 5)
> 
>     (cl-reduce f '(1 2 3 4 5) :from-end t)
>       ↔ (f 1 (f 2 (f 3 (f 4 5))))
> 
>     (cl-reduce f '(1 2 3 4 5) :from-end t :initial-value 0)
>       ↔ (f 1 (f 2 (f 3 (f 4 (f 5 0)))))

LGTM - except that f should be quoted as an arg to `cl-reduce'.
E.g. (cl-reduce 'f '(1 2 3)).

And a shorter list makes things a tiny bit simpler: (1 2 3).

(And I'm not crazy about the too-short double arrow, personally.)

Previous Next

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997,2003 nCipher Corporation Ltd, 1994-97 Ian Jackson.