From f4b67e8bd815c132fa4a602e80f9f21c57216878 Mon Sep 17 00:00:00 2001
From: Tuukka Turto <tuukka.turto@oktaeder.net>
Date: Mon, 21 Apr 2014 13:28:08 +0300
Subject: [PATCH] documentation for doto relates #567

---
 docs/language/api.rst | 21 +++++++++++++++++++++
 1 file changed, 21 insertions(+)

diff --git a/docs/language/api.rst b/docs/language/api.rst
index fe3575e..f5b1ac5 100644
--- a/docs/language/api.rst
+++ b/docs/language/api.rst
@@ -560,6 +560,27 @@ del
   => dic
   {}
 
+doto
+----
+
+`doto` macro is used to make repetitive calls to an object easy. Following
+example demonstrates this.
+
+.. code-block:: clj
+
+  => (setv collection [])
+  => (doto collection (.append 1) (.append 2))
+  => collection
+  [1 2]
+
+.. code-block:: clj
+
+  => (setv collection [])
+  => (.append 1 collection)
+  => (.append 2 collection)
+  => collection
+  [1 2]
+
 eval
 ----