Update docs

Author: alexander-yakushev

CHANGELOG.md

@@ -2,6 +2,12 @@
 
 ## master (unreleased)
 
+* Bump `orchard` to [0.31.0](https://github.com/clojure-emacs/orchard/blob/master/CHANGELOG.md#0310-2025-03-14).
+  - Info: recognize printed Java classes/methods and munged Clojure functions in stacktrace outputs.
+  - Add dedicated renderers for exceptions in inspector and debugger.
+* [#919](https://github.com/clojure-emacs/cider-nrepl/pull/919): Move exception analysis to Orchard.
+  - **BREAKING**: Remove `analyze-stacktrace` and `cider/log-analyze-stacktrace` ops.
+  - Stop vendoring Haystack dependency.
 * [#913](https://github.com/clojure-emacs/cider-nrepl/pull/913): Disable background warmup of `orchard.java` cache.
 * [#913](https://github.com/clojure-emacs/cider-nrepl/pull/913): Enable background warmup of Compliment cache.
 * [#914](https://github.com/clojure-emacs/cider-nrepl/pull/914): Remove javadoc section from the inspector output.

doc/modules/ROOT/pages/nrepl-api/ops.adoc

@@ -29,57 +29,6 @@ Returns::
 
 
 
-=== `analyze-stacktrace`
-
-Parse and analyze the ``:stacktrace``
-parameter and return messages describing each cause and stack frame. The
-stacktrace must be a string formatted in one of the following formats:
-
-* ``:aviso`` Stacktraces printed with the
-  https://ioavisopretty.readthedocs.io/en/latest/exceptions.html[write-exception]
-  function of the https://github.com/AvisoNovate/pretty[Aviso] library.
-
-* ``:clojure.tagged-literal`` Stacktraces printed as a tagged literal, like a
-  https://docs.oracle.com/javase/8/docs/api/java/lang/Throwable.html[java.lang.Throwable]
-  printed with the
-  https://clojure.github.io/clojure/branch-master/clojure.core-api.html#clojure.core/pr[pr]
-  function.
-
-* ``:clojure.stacktrace`` Stacktraces printed with the
-  https://clojure.github.io/clojure/branch-master/clojure.stacktrace-api.html#clojure.stacktrace/print-cause-trace[print-cause-trace]
-  function of the
-  https://clojure.github.io/clojure/branch-master/clojure.stacktrace-api.html[clojure.stacktrace]
-  namespace.
-
-* ``:clojure.repl`` Stacktraces printed with the
-  https://clojure.github.io/clojure/branch-master/clojure.repl-api.html#clojure.repl/pst[pst]
-  function of the
-  https://clojure.github.io/clojure/branch-master/clojure.repl-api.html[clojure.repl]
-  namespace.
-
-* ``:java`` Stacktraces printed with the
-  link:++https://docs.oracle.com/javase/8/docs/api/java/lang/Throwable.html#printStackTrace--++[printStackTrace]
-  method of
-  https://docs.oracle.com/javase/8/docs/api/java/lang/Throwable.html[java.lang.Throwable].
-
-Required parameters::
-* `:stacktrace` The stacktrace to be parsed and analyzed as a string.
-
-
-Optional parameters::
-* `:nrepl.middleware.print/buffer-size` The size of the buffer to use when streaming results. Defaults to 1024.
-* `:nrepl.middleware.print/keys` A seq of the keys in the response whose values should be printed.
-* `:nrepl.middleware.print/options` A map of options to pass to the printing function. Defaults to ``nil``.
-* `:nrepl.middleware.print/print` A fully-qualified symbol naming a var whose function to use for printing. Must point to a function with signature [value writer options].
-* `:nrepl.middleware.print/quota` A hard limit on the number of bytes printed for each value.
-* `:nrepl.middleware.print/stream?` If logical true, the result of printing each value will be streamed to the client over one or more messages.
-
-
-Returns::
-* `:status` "done", or "no-error" if ``stracktrace`` is not recognized
-
-
-
 === `apropos`
 
 Return a sequence of vars whose name matches the query pattern, or if specified, having the pattern in their docstring.
@@ -1521,24 +1470,6 @@ Returns::
 
 
 
-=== `cider/log-analyze-stacktrace`
-
-Analyze the stacktrace of a log event.
-
-Required parameters::
-* `:appender` The name of the appender.
-* `:event` The id of the event to inspect.
-* `:framework` The id of the log framework.
-
-
-Optional parameters::
-{blank}
-
-Returns::
-* `:status` done
-
-
-
 === `cider/log-clear-appender`
 
 Clear all events of a log appender.

src/cider/nrepl.clj

@@ -415,13 +415,6 @@ if applicable, and re-render the updated value."
      :returns {"status" "done"
                "cider/log-add-consumer" "The consumer that was added."}}
 
-    "cider/log-analyze-stacktrace"
-    {:doc "Analyze the stacktrace of a log event."
-     :requires {"framework" "The id of the log framework."
-                "appender" "The name of the appender."
-                "event" "The id of the event to inspect."}
-     :returns {"status" "done"}}
-
     "cider/log-clear-appender"
     {:doc "Clear all events of a log appender."
      :requires {"framework" "The id of the log framework."
@@ -708,39 +701,6 @@ Assumes that `analyze-last-stacktrace` has been called first, returning \"no-err
                                         :requires {"index" "0 for inspecting the top-level exception, 1 for its ex-cause, 2 for its ex-cause's ex-cause, and so on."}
                                         :returns {"status" "\"done\", or \"no-error\" if `analyze-last-stacktrace` wasn't called beforehand (or the `index` was out of bounds)."
                                                   "value" "A value, as produced by the Inspector middleware."}}
-              "analyze-stacktrace" {:doc "Parse and analyze the `:stacktrace`
-parameter and return messages describing each cause and stack frame. The
-stacktrace must be a string formatted in one of the following formats:
-
-* `:aviso` Stacktraces printed with the
-  https://ioavisopretty.readthedocs.io/en/latest/exceptions.html[write-exception]
-  function of the https://github.com/AvisoNovate/pretty[Aviso] library.
-
-* `:clojure.tagged-literal` Stacktraces printed as a tagged literal, like a
-  https://docs.oracle.com/javase/8/docs/api/java/lang/Throwable.html[java.lang.Throwable]
-  printed with the
-  https://clojure.github.io/clojure/branch-master/clojure.core-api.html#clojure.core/pr[pr]
-  function.
-
-* `:clojure.stacktrace` Stacktraces printed with the
-  https://clojure.github.io/clojure/branch-master/clojure.stacktrace-api.html#clojure.stacktrace/print-cause-trace[print-cause-trace]
-  function of the
-  https://clojure.github.io/clojure/branch-master/clojure.stacktrace-api.html[clojure.stacktrace]
-  namespace.
-
-* `:clojure.repl` Stacktraces printed with the
-  https://clojure.github.io/clojure/branch-master/clojure.repl-api.html#clojure.repl/pst[pst]
-  function of the
-  https://clojure.github.io/clojure/branch-master/clojure.repl-api.html[clojure.repl]
-  namespace.
-
-* `:java` Stacktraces printed with the
-  link:++https://docs.oracle.com/javase/8/docs/api/java/lang/Throwable.html#printStackTrace--++[printStackTrace]
-  method of
-  https://docs.oracle.com/javase/8/docs/api/java/lang/Throwable.html[java.lang.Throwable]."
-                                    :requires {"stacktrace" "The stacktrace to be parsed and analyzed as a string."}
-                                    :optional wrap-print-optional-arguments
-                                    :returns {"status" "\"done\", or \"no-error\" if `stracktrace` is not recognized"}}
               "stacktrace" {:doc "Return messages describing each cause and
 stack frame of the most recent exception. This op is deprecated, please use the
 `analyze-last-stacktrace` op instead."