[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
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- [elpa] externals/dash 3df46d7d9f: Give -concat alias a stable docstring,
ELPA Syncer <=