emacs-elpa-diffs
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

[elpa] externals/dash 3df46d7d9f: Give -concat alias a stable docstring


From: ELPA Syncer
Subject: [elpa] externals/dash 3df46d7d9f: Give -concat alias a stable docstring
Date: Thu, 13 Oct 2022 04:57:37 -0400 (EDT)

branch: externals/dash
commit 3df46d7d9fe74f52a661565888e4d31fd760f0df
Author: Basil L. Contovounesios <contovob@tcd.ie>
Commit: Basil L. Contovounesios <contovob@tcd.ie>

    Give -concat alias a stable docstring
    
    Otherwise upstream changes to the docstring of append will cause
    needless churn, as well as annoyances for contributors on different
    Emacs versions.
    
    * dash.el (-concat): Give it append's current upstream docstring.
    * README.md:
    * dash.texi: Regenerate docs.
---
 README.md |  4 +++-
 dash.el   | 10 +++++++++-
 dash.texi |  4 +++-
 3 files changed, 15 insertions(+), 3 deletions(-)

diff --git a/README.md b/README.md
index 7351eb43d5..b9712bf118 100644
--- a/README.md
+++ b/README.md
@@ -804,7 +804,9 @@ Its anaphoric counterpart is `--keep`.
 Concatenate all the arguments and make the result a list.
 The result is a list whose elements are the elements of all the arguments.
 Each argument may be a list, vector or string.
-The last argument is not copied, just used as the tail of the new list.
+
+All arguments except the last argument are copied.  The last argument
+is just used as the tail of the new list.
 
 ```el
 (-concat '(1)) ;; => (1)
diff --git a/dash.el b/dash.el
index e04201ff22..6efdc24ea4 100644
--- a/dash.el
+++ b/dash.el
@@ -762,7 +762,15 @@ See also: `-flatten'"
     (setq list (apply #'append (mapcar #'-list list))))
   list)
 
-(defalias '-concat #'append)
+(defalias '-concat #'append
+  "Concatenate all the arguments and make the result a list.
+The result is a list whose elements are the elements of all the arguments.
+Each argument may be a list, vector or string.
+
+All arguments except the last argument are copied.  The last argument
+is just used as the tail of the new list.
+
+\(fn &rest SEQUENCES)")
 
 (defalias '-copy 'copy-sequence
   "Create a shallow copy of LIST.
diff --git a/dash.texi b/dash.texi
index a868cfddad..9226c304de 100644
--- a/dash.texi
+++ b/dash.texi
@@ -910,7 +910,9 @@ Its anaphoric counterpart is @code{--keep}.
 Concatenate all the arguments and make the result a list.
 The result is a list whose elements are the elements of all the arguments.
 Each argument may be a list, vector or string.
-The last argument is not copied, just used as the tail of the new list.
+
+All arguments except the last argument are copied.  The last argument
+is just used as the tail of the new list.
 
 @example
 @group



reply via email to

[Prev in Thread] Current Thread [Next in Thread]