From 6cf2cd52b882ba2b8499ba9737d028253a8055cb Mon Sep 17 00:00:00 2001
From: Sean Corfield <sean@corfield.org>
Date: Tue, 19 Oct 2021 10:16:34 -0700
Subject: [PATCH] improve with-transaction docstring #188

---
 src/next/jdbc.clj | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/src/next/jdbc.clj b/src/next/jdbc.clj
index 4e1a247..4a74a9d 100644
--- a/src/next/jdbc.clj
+++ b/src/next/jdbc.clj
@@ -359,8 +359,9 @@
   The options map supports:
   * `:isolation` -- `:none`, `:read-committed`, `:read-uncommitted`,
       `:repeatable-read`, `:serializable`,
-  * `:read-only` -- `true` / `false`,
-  * `:rollback-only` -- `true` / `false`."
+  * `:read-only` -- `true` / `false` (`true` will make the `Connection` readonly),
+  * `:rollback-only` -- `true` / `false` (`true` will make the transaction
+      rollback, even if it would otherwise succeed)."
   [[sym transactable opts] & body]
   (let [con (vary-meta sym assoc :tag 'java.sql.Connection)]
    `(transact ~transactable (^{:once true} fn* [~con] ~@body) ~(or opts {}))))