[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[elpa] externals/dash 6911514 221/426: Update docs too
From: |
Phillip Lord |
Subject: |
[elpa] externals/dash 6911514 221/426: Update docs too |
Date: |
Tue, 04 Aug 2015 19:37:52 +0000 |
branch: externals/dash
commit 691151431ef8fc00415d23bcc30ef66da12a2e81
Author: Magnar Sveen <address@hidden>
Commit: Magnar Sveen <address@hidden>
Update docs too
---
README.md | 31 +++++++++++++++++++++----------
1 files changed, 21 insertions(+), 10 deletions(-)
diff --git a/README.md b/README.md
index a0cab04..069f462 100644
--- a/README.md
+++ b/README.md
@@ -2,6 +2,21 @@
A modern list api for Emacs. No 'cl required.
+## Breaking change 1.8.0 -> 2.0.0
+
+- The `-min` and `-max` functions are no longer variadic, but take a
+ list to be more in line with the other dash functions.
+
+- The `-min-by` and `-max-by` now take a comparator function to sort by.
+
+Also: The stated scope of dash is increasing. It now includes more
+functional style functions, like combinators and threading macros.
+These have been creeping in anyway, since they're so darn useful. Time
+to make it official. :)
+
+These new combinators require Emacs 24 for its lexical scope. So
+you'll have to include them with `(require 'dash-functional)`.
+
## Installation
It's available on [marmalade](http://marmalade-repo.org/) and
[Melpa](http://melpa.milkbox.net/):
@@ -350,7 +365,7 @@ comparing them.
```cl
(-min-by '> '(4 3 6 1)) ;; => 1
(-min-by (-on '> 'length) '((1 2 3) (1) (1 2))) ;; => '(1)
-(-min-by (-on 'string-lessp 'int-to-string) '(2 100 22)) ;; => 22
+(--min-by (> (length it) (length other)) '((1 2 3) (1) (1 2))) ;; => '(1)
```
### -max `(list)`
@@ -374,7 +389,7 @@ comparing them.
```cl
(-max-by '> '(4 3 6 1)) ;; => 6
(-max-by (-on '> 'car) '((2 2 3) (3) (1 2))) ;; => '(3)
-(-max-by (-on '> 'string-to-int) '("1" "2" "3")) ;; => "3"
+(--max-by (> (car it) (car other)) '((2 2 3) (3) (1 2))) ;; => '(3)
```
### -any? `(pred list)`
@@ -1085,15 +1100,11 @@ Change `readme-template.md` or `examples-to-docs.el`
instead.
## Changelist
-### From 1.8.0 to master
-
-The stated scope of dash is increasing. It now includes more
-functional style functions, like combinators and threading macros.
-These have been creeping in anyway, since they're so darn useful. Time
-to make it official. :)
+### From 1.8.0 to 2.0.0
- Split out `dash-functional.el` (Matus Goljer)
- Add `-andfn`, `-orfn`, `-not`, `-cut`, `-const`, `-flip` and `-on`. (Matus
Goljer)
+- Fix `-min`, `-max`, `-min-by` and `-max-by` (Matus Goljer)
### From 1.7.0 to 1.8.0
@@ -1132,14 +1143,14 @@ to make it official. :)
## Contributors
- - [Matus Goljer](https://github.com/Fuco1) contributed `-union`, `-separate`,
`-zip`, `-zip-with`, `-reduce-r`, `-reduce-r-from` and `-rotate`.
+ - [Matus Goljer](https://github.com/Fuco1) contributed lots of features and
functions.
- [Takafumi Arakaki](https://github.com/tkf) contributed `-group-by`.
- [tali713](https://github.com/tali713) is the author of `-applify`.
- [VĂctor M. Valenzuela](https://github.com/vemv) contributed `-repeat`.
- [Nic Ferrier](https://github.com/nicferrier) contributed `-cons*`.
- [Wilfred Hughes](https://github.com/Wilfred) contributed `-slice`,
`-first-item` and `-last-item`.
- [Emanuel Evans](https://github.com/shosti) contributed `-if-let`,
`-when-let` and `-insert-at`.
- - [Johan Andersson](https://github.com/rejeep) contributed `-sum`,
`-product`, `-min`, `-max`, `-min-by` and `-max-by`.
+ - [Johan Andersson](https://github.com/rejeep) contributed `-sum` and
`-product`.
Thanks!
- [elpa] externals/dash 8b17154 204/426: Release 1.7.0, (continued)
- [elpa] externals/dash 8b17154 204/426: Release 1.7.0, Phillip Lord, 2015/08/04
- [elpa] externals/dash 0db2f5a 208/426: Fix second example for -last/first-item, Phillip Lord, 2015/08/04
- [elpa] externals/dash 788573e 206/426: Merge pull request #36 from Wilfred/master, Phillip Lord, 2015/08/04
- [elpa] externals/dash b1cfe18 209/426: Fix incorrect alias checking in docs--signature, Phillip Lord, 2015/08/04
- [elpa] externals/dash 37064b5 213/426: Include @Fuco1 in Authors/Copyright + fix README, Phillip Lord, 2015/08/04
- [elpa] externals/dash 824fcb3 207/426: Release 1.8.0, Phillip Lord, 2015/08/04
- [elpa] externals/dash d6ca7d9 215/426: Fix E23 bug and re-enable E23 CI, Phillip Lord, 2015/08/04
- [elpa] externals/dash 86de963 217/426: Add docs about require for dash-functional, Phillip Lord, 2015/08/04
- [elpa] externals/dash 9abae5e 211/426: Add combinators, Phillip Lord, 2015/08/04
- [elpa] externals/dash 51c9f6b 212/426: Merge pull request #42 from Fuco1/functional, Phillip Lord, 2015/08/04
- [elpa] externals/dash 6911514 221/426: Update docs too,
Phillip Lord <=
- [elpa] externals/dash 9a149bf 219/426: Add anaphoric example to --max-by and --min-by, Phillip Lord, 2015/08/04
- [elpa] externals/dash 4a144c6 220/426: Release 2.0.0, Phillip Lord, 2015/08/04
- [elpa] externals/dash d374fcc 214/426: Revert "Add combinators", Phillip Lord, 2015/08/04
- [elpa] externals/dash 2a7fbdc 218/426: Update -max-by & friends, Phillip Lord, 2015/08/04
- [elpa] externals/dash 6d0a8d6 225/426: Add Version and Package-Requires to files #45, Phillip Lord, 2015/08/04
- [elpa] externals/dash d365f22 222/426: Fix byte compile warnings, Phillip Lord, 2015/08/04
- [elpa] externals/dash 81e43ad 229/426: Add -union to list of highlighted symbols., Phillip Lord, 2015/08/04
- [elpa] externals/dash 9b0166a 224/426: Fix terminology, Phillip Lord, 2015/08/04
- [elpa] externals/dash dbcb3ef 231/426: Update README, Phillip Lord, 2015/08/04
- [elpa] externals/dash 515e2d3 230/426: Use `comparator` instead of `predicate` for sort., Phillip Lord, 2015/08/04