branch: externals/dash
commit 656e5da15da99eb5936fdd1ebe00c80730e1fd96
Author: Philip Kaludercic <[email protected]>
Commit: Basil L. Contovounesios <[email protected]>
Rewrite "Commentary" section
The intention is to have a standalone description for
'describe-package' that gives a self contained answer to the
questions "what?" and "why?". For discussion, see:
https://lists.gnu.org/r/emacs-devel/2026-02/msg00540.html
* dash.el: Expand Commentary.
---
dash.el | 16 +++++++++++++---
1 file changed, 13 insertions(+), 3 deletions(-)
diff --git a/dash.el b/dash.el
index d012dd666e..b4feee43a5 100644
--- a/dash.el
+++ b/dash.el
@@ -24,9 +24,19 @@
;;; Commentary:
-;; A modern list API for Emacs.
-;;
-;; See its overview at https://github.com/magnars/dash.el#functions.
+;; Dash is a library implementing utility functions to help fascilitate
+;; Clojure-style functional programming patterns, such as providing
+;; various higher-order functions (map, reduce, filter, ...) and derived
+;; functionality (drop, flatten, sum, ...), functional combinators
+;; (partial application, argument flipping, composition, ...) and
+;; threading and anaphoric macros with destructuring support.
+
+;; Dash is commonly used to provide a common baseline for consistent
+;; functions, which is especially useful for packages that want to
+;; support older releases of Emacs.
+
+;; For further details please consult the Info node `(dash) Top' or read
+;; the manual via the WWW: https://elpa.gnu.org/packages/doc/dash.html.
;;; Code:
