From 20eb3315ca8a459471be7bf71c1dc5ab8e6b94ea Mon Sep 17 00:00:00 2001
From: Christina Whyte <kurisu.whyte@gmail.com>
Date: Sat, 31 Aug 2013 16:49:43 -0300
Subject: [PATCH] Updates the documentation.

---
 README.md | 15 +++++++++++++++
 1 file changed, 15 insertions(+)

diff --git a/README.md b/README.md
index d4431e4..3611b7b 100644
--- a/README.md
+++ b/README.md
@@ -164,6 +164,7 @@ These combinators require Emacs 24 for its lexical scope. So they are offered in
 * [-partial](#-partial-fn-rest-args) `(fn &rest args)`
 * [-rpartial](#-rpartial-fn-rest-args) `(fn &rest args)`
 * [-juxt](#-juxt-rest-fns) `(&rest fns)`
+* [-compose](#-compose-rest-fns) `(&rest fns)`
 * [-applify](#-applify-fn) `(fn)`
 * [-on](#-on-operator-transformer) `(operator transformer)`
 * [-flip](#-flip-func) `(func)`
@@ -1134,6 +1135,20 @@ applying each fn to the args (left-to-right).
 (-map (-juxt 'identity 'square) '(1 2 3)) ;; => '((1 1) (2 4) (3 9))
 ```
 
+#### -compose `(&rest fns)`
+
+Takes a list of functions and returns a fn that is the
+composition of those fns. The returned fn takes a variable
+number of arguments, and returns the result of applying
+each fn to the result of applying the previous fn to
+the arguments (right-to-left).
+
+```cl
+(funcall (-compose 'square '+) 2 3) ;; => (square (+ 2 3))
+(funcall (-compose 'identity 'square) 3) ;; => (square 3)
+(funcall (-compose 'square 'identity) 3) ;; => (square 3)
+```
+
 #### -applify `(fn)`
 
 Changes an n-arity function `fn` to a 1-arity function that