Improve instructions for updating nREPL

Author: bbatsov

cider-connection.el

@@ -66,7 +66,7 @@ available) and the matching REPL buffer."
   :safe #'booleanp
   :package-version '(cider . "0.9.0"))
 
-(defconst cider-required-nrepl-version "0.4.4"
+(defconst cider-required-nrepl-version "0.6.0"
   "The minimum nREPL version that's known to work properly with CIDER.")
 
 
@@ -191,11 +191,11 @@ FORMAT is a format string to compile with ARGS and display on the REPL."
   "Check whether we're using a compatible nREPL version."
   (if-let* ((nrepl-version (cider--nrepl-version)))
       (when (version< nrepl-version cider-required-nrepl-version)
-        (cider-emit-manual-warning "troubleshooting.html#_warning_saying_you_have_to_use_nrepl_0_4_4"
+        (cider-emit-manual-warning "troubleshooting.html#_warning_saying_you_have_to_use_newer_nrepl"
                                    "CIDER requires nREPL %s (or newer) to work properly"
                                    cider-required-nrepl-version))
-    (cider-emit-manual-warning "troubleshooting.html#_warning_saying_you_have_to_use_nrepl_0_4_4"
-                               "Can't determine nREPL's version.\nPlease, update nREPL to %s."
+    (cider-emit-manual-warning "troubleshooting.html#_warning_saying_you_have_to_use_newer_nrepl"
+                               "Can't determine nREPL's version.\nPlease, update nREPL to %s (or newer)."
                                cider-required-nrepl-version)))
 
 (defvar cider-minimum-clojure-version)

doc/modules/ROOT/pages/troubleshooting.adoc

@@ -96,18 +96,21 @@ This will bring up a backtrace with the entire function stack, including
 function arguments. So you should be able to figure out what's going on (or at
 least what's being required).
 
-=== Warning saying you have to use nREPL 0.4.4+
+=== Warning saying you have to use newer nREPL
 
-CIDER currently requires at least nREPL 0.4.4 to work properly (there were some
-nasty bugs in older version and no support for tracking where some var was
-defined in the source code). Leiningen users can add this to their
-`profiles.clj` to force the proper dependency:
+CIDER currently requires at least nREPL 0.6 to work properly. As nREPL comes
+bundled with Leiningen and Boot, from time to time you might have to override the
+version supplied by them (e.g. if you're forced to use an older version of
+Leiningen or there's no release bundling the required nREPL version yet). Leiningen
+users can add this to their `profiles.clj` to force the proper dependency:
 
 [source,clojure]
 ----
 {:repl {:dependencies [[nrepl/nrepl "x.y.z"]]}}
 ----
 
+The procedure is pretty similar for Boot.
+
 IMPORTANT: Make sure you add the newer nREPL dependency to the `:dependencies` key instead
 of `:plugins` (where `cider-nrepl` Lein plugin resides). That's a pretty common
 mistake.