[elpa] externals/dash 6911514 221/439: Update docs too

[Phillip Lord]

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!