bug#42323: 26.3; Doc string of `seq-map'

[Lars Ingebrigtsen]

Michael Heerdegen <michael_heerdegen@web.de> writes:

> Details: yes, it's good to have a list of implementations.

The implementations are a way to optimise the functions -- they provide
no (well, little) information needed to use the functions.  So I'd argue
that they aren't needed by users.

That is, whether seq-map is optimised by doing

(defun seq-map (function sequence)
  (if (eq (type-of sequence) 'list)
      (seq-map-list ...)
    (seq-map-general ...)))

or whether that's achieved by defgeneric is immaterial to people using
seq-map: The interface to use remains identical.

> I wonder to what that is actually referring to.  There is only one
> implementation in seq.el...?

There's two:

(cl-defgeneric seq-map (function sequence)
(cl-defmethod seq-map (function (sequence sequence))

-- 
(domestic pets only, the antidote for overdose, milk.)
   bloggy blog: http://lars.ingebrigtsen.no