GNU bug report logs - #73431
Add `setf` support for `stream.el` in ELPA

Previous Next

Package: emacs;

Reported by: Okamsn <okamsn <at> protonmail.com>

Date: Mon, 23 Sep 2024 01:35:01 UTC

Severity: wishlist

Done: Stefan Monnier <monnier <at> iro.umontreal.ca>

Bug is archived. No further changes may be made.

Full log


Message #199 received at submit <at> debbugs.gnu.org (full text, mbox):

From: Okamsn <okamsn <at> protonmail.com>
To: Michael Heerdegen <michael_heerdegen <at> web.de>
Cc: philipk <at> posteo.net, "Michael Heerdegen via \"Bug reports for GNU Emacs,
 the Swiss army knife of text editors\"" <bug-gnu-emacs <at> gnu.org>,
 monnier <at> iro.umontreal.ca, Eli Zaretskii <eliz <at> gnu.org>, nicolas <at> petton.fr,
 73431 <at> debbugs.gnu.org
Subject: Re: bug#73431: Add `setf` support for `stream.el` in ELPA
Date: Fri, 08 Nov 2024 01:45:47 +0000
[Message part 1 (text/plain, inline)]
Michael Heerdegen wrote:
> Okamsn <okamsn <at> protonmail.com> writes:
> 
>> For shortening the first line of the documentation of `seq-take-while`,
>> do you think changing "Return a stream of the successive elements for
>> which (PRED elt) is non-nil in STREAM" to "Return a stream of serial
>> elements in STREAM for which PRED returns non-nil" works?
> 
> Hmm.  How about
> 
> "Return the starting consecutive elements that fulfill PRED."
> 
> Or "front elements"?
> 
> I tried to emphasize that the function is not about the whole sequence
> but starts at the front and aborts once PRED is not fulfilled.  We can
> later say explicitly that the predicate is called like (PRED ELT) - that
> alone makes the sentence shorter.
> 
> But I'm not that good when using English language - better versions
> welcome.
> 
>> Also, do you think that the documentation string for `seq-drop-while`
>> should also be changed for consistency?
> 
> Sure.
> 
> 
> Michael.

Hello,

Attached are patch files which include the requested shorter doc strings 
for `seq-take-while` and `seq-drop-while`.  The quoting in `seq-mapn` 
has been fixed. I did not delete any of the doc strings because there 
does not seem to be consensus on that.

Is there anything else that you would like changed outside of the 
discussion about the doc strings?

Thank you.
[v5-0007-Shorten-the-documentation-strings-of-seq-take-whi.patch (text/x-patch, attachment)]
[v5-0006-Fix-the-quoting-in-the-documentation-of-seq-mapn-.patch (text/x-patch, attachment)]
[v5-0005-Add-test-for-delayed-evaluation-for-seq-drop-whil.patch (text/x-patch, attachment)]
[v5-0004-Add-an-implementation-of-seq-concatenate-for-stre.patch (text/x-patch, attachment)]
[v5-0003-Add-generalized-variables-for-streams-that-error-.patch (text/x-patch, attachment)]
[v5-0002-Add-more-efficient-method-for-making-streams-from.patch (text/x-patch, attachment)]
[v5-0001-Change-stream.el-to-use-structures-instead-of-con.patch (text/x-patch, attachment)]

This bug report was last modified 264 days ago.

Previous Next


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