[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
bug#42323: 26.3; Doc string of `seq-map'
From: |
Lars Ingebrigtsen |
Subject: |
bug#42323: 26.3; Doc string of `seq-map' |
Date: |
Wed, 09 Dec 2020 14:41:58 +0100 |
User-agent: |
Gnus/5.13 (Gnus v5.13) Emacs/28.0.50 (gnu/linux) |
Drew Adams <drew.adams@oracle.com> writes:
> Or IF understanding the implementation is really necessary, then the
> fact that seq.el is implemented using cl constructs can't be elided.
This is the current doc string:
---
seq-map is a compiled Lisp function in ‘seq.el’.
(seq-map FUNCTION SEQUENCE)
Other relevant functions are documented in the sequence group.
Return the result of applying FUNCTION to each element of SEQUENCE.
This is a generic function.
Implementations:
#'(sequence sequence) in ‘seq.el’.
Undocumented
#'sequence in ‘seq.el’.
Undocumented
---
It is, indeed, pretty obscure. Like Drew, I wonder -- do we really have
to put these implementation details in the doc string at all? Opinions?
--
(domestic pets only, the antidote for overdose, milk.)
bloggy blog: http://lars.ingebrigtsen.no
- bug#42323: 26.3; Doc string of `seq-map',
Lars Ingebrigtsen <=