Document :repl-options :caught. Refs #799.

sample.project.clj

@@ -323,6 +323,9 @@
                  ;; This expression will run when first opening a REPL, in the
                  ;; namespace from :init-ns or :main if specified.
                  :init (println "here we are in" *ns*)
+                 ;; Print stack traces on exceptions (highly recommended, but
+                 ;; currently overwrites *1, *2, etc).
+                 :caught clojure.repl/pst
                  ;; Skip's the default requires and printed help message.
                  :skip-default-init false
                  ;; Customize the socket the repl task listens on and

src/leiningen/repl.clj

@@ -246,8 +246,9 @@ Subcommands:
   If no dest is given, resolves the host resolved as described above
   and the port from LEIN_REPL_PORT, :repl-options, or .nrepl-port in
   the project root, in that order.
-  
-Note: the :repl profile is implicitly activated for this task, and cannot be deactivated."
+
+Note: the :repl profile is implicitly activated for this task. It cannot be
+deactivated, but it can be overridden."
 
   ([project] (repl project ":start"))
   ([project subcommand & opts]